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FCC Class B Notice 


This equipment has been tested and found to comply with the limits for a Class B digital device, 
pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection 
against harmful interference in a residential installation. This equipment generates, uses and can 
radiate radio frequency energy and, if not installed and used in accordance with the instructions, may 
cause harmful interference to radio communications. However, there is no guarantee that interference 
will not occur in a particular installation. If this equipment does cause harmful interference to radio or 
television reception, which can be determined by turning the equipment off and on, the user is 
encouraged to try to correct the interference by one or more of the following measures: 

¢ Reorient or relocate the receiving antenna 

¢ Increase the separation between the equipment and receiver 

* Connect the equipment into an outlet on a circuit different from that to which the 

* receiver is connected 

¢ Consult your supplier, or an experienced radio or television technician for help 


Modifications 


This equipment contains no user-serviceable parts. You are advised that unauthorized changes or 
modifications to the equipment could cause it to exceed Class B limits and may void the authority 
granted by the FCC to operate the equipment. 


Shielded Cables 


Connections between the SPARCbook and any connected peripherals must be made using shielded 
cables to maintain compliance with FCC radio frequency emission limits. 


FCC Part 68 Modem Information 


This equipment complies with Part 68 of the FCC rules. On the underside of this equipment is a label 
that contains, among other information, the FCC registration number and ringer equivalence number 
(REN) for this equipment. If requested, this information must be provided to the telephone company. 


This equipment uses the following USOC jacks: RJ11C 


The REN is used to determine the quantity of devices which may be connected to the telephone line. 
Excessive RENs on the telephone line may result in the devices not ringing in response to an incoming 
call. In most, but not all areas, the sum of the RENs should not exceed five (5.0). To be certain of the 
number of devices that may be connected to the line, as determined by the total RENs, contact the 
telephone company to determine the maximum REN for the calling area. 


If this equipment causes harm to the telephone network, the telephone company will notify you in 
advance that temporary discontinuance of service may be required. If advance notice is not practical, 
the telephone company will notify the customer as soon as possible. Also, you will be advised of your 
right to file a complaint with the FCC if you believe it is necessary. 


The telephone company may make changes in its facilities, equipment, operations or procedures that 
could affect the operation of the equipment. If this happens, the telephone company will provide 
advance notice in order for you to make the necessary modifications in order to maintain uninterrupted 


service. 


If trouble is experienced with this equipment, please contact Tadpole Technology Inc, 12012 
Technology Boulevard, Austin, Texas 78737 Tel: 512-219-2200 for repair and/or warranty 
information. If the trouble is causing harm to the telephone network, the telephone company may 
request you remove the equipment from the network until the problem is resolved. 


The following repairs can be done by the customer: None 


This equipment cannot be used on telephone company-provided coin service. Connection to Party Line 
Service is subject to state tariffs. 


The Telephone Consumer Protection Act of 1991 makes it unlawful for any person to use a computer 
or any other elctronic device to send messages via a telephone fax machine unless such a message 
contains in a margin at the top or bottom of each transmitted page or on the first page of the 
transmission, the date and time it is sent and an identification of the business or other entity, or other 
individual sending the message and the telephone number of the sending machine or such business, 
other entity, or individual. 


In order to program this information into the SPARCbook 2 notebook workstation, you should follow 
the steps described in ‘Sending a Fax’ on page 108. 


Trademarks 


All rights reserved. This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution and 
decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its 
licensors, if any. This product or the products depicted herein may be protected by one or more U.S. or international patents or pending patents. Portions of 
this product may be derived from the UNIX® and Berkeley 4.3 BSD systems, licensed from UNIX Systems Laboratories, Inc. and the University of 


California, respectively. Third party font software in this product is protected by copyright and licensed from Sun’s Font Suppliers. 
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INTRODUCTION TO THE 
SPARCbook 2 
USER GUIDE 


This guide is written and structured to be easy to use. It assumes a basic knowledge of computers 
and is intended to enable you to quickly understand and be able to use the facilities provided in the 
SPARCbook 2 notebook computer. You do not need to have used the UNIX Operating System to be 
able to follow this guide and to use the SPARCbook 2 product. However, if you do not have 
experience of Sun or any other UNIX based computers, you are recommended to refer to the 
documentation set available from SunSoft Inc. Please contact your local sales office for further 


information. 
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GUIDE SUMMARY 


GUIDE SUMMARY 


The guide is separated into the following sections: 
¢ THIS INTRODUCTION 


* INTRODUCTION TO SPARCbook 2 
Identifies the SPARCbook 2 system components and explains how to unpack and 
initially set up the system. This section also tells you about charging the internal 
battery, running the system from the battery and the charger/adapter, switching the 


system on and off, the keyboard, and the Mousekey. 


¢ CONFIGURING SPARCbook 2 
Provides information on starting up the system for the first time and setting it up for 


networked or non-networked operation. 


¢ THE DESKSET USER INTERFACE 
Provides an introduction to the OpenWindows environment which operates on the 
SPARCbook 2. 


¢ THE DESKSET TOOLS 
Provides an introduction to the OpenWindows Version 3 facilities and gives a brief 


tutorial on the main features and productivity tools provided on SPARCbook 2. 


¢ CONFIGURING YOUR DESKSET ENVIRONMENT 
Discusses how to change the default DeskSet applications that are started up and the 


appearance of the screen to suit your own requirements. 


* POWER MANAGEMENT 
Describes the Power Management facilities such as charging the battery and 
changing battery packs and the various power management techniques used in the 


design of the system to maximize battery life. 


¢ CONNECTING AND USING EXTERNAL DEVICES 
Describes how to connect external devices, including printer, mouse, keyboard and a 


color monitor, and how to configure them to run with SPARCbook 2. 
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GUIDE SUMMARY 


USING THE INTERNAL MODEM 
Explains how to configure and use the internal modem for Fax and data 


communication. 


USING THE NETWORK INTERFACE 
Discusses how to configure the SPARCbook 2 for a network, how to connect it and 


how to use the facilities available to a networked SPARCbook 2. 


BACKUP AND RESTORE 
Explains how to make a complete backup of the supplied software in case of data 


loss, and how to restore it back onto the disk. 


RUNNING SPARC APPLICATIONS 

Describes how to install and run third party SPARC applications on SPARCbook 2. 
While all SPARC Compliance Definition (SCD) applications will run unmodified, 

there are some hardware differences between the SPARCbook 2 and other SPARC 


platforms which can affect the way applications are set up and run. 


CUSTOMIZING THE SPARCbook OPERATING SYSTEM 

Explains how to customize the Solaris Operating System to meet your own 
requirements. As shipped, the Solaris Operating System for SPARCbook 2 is a subset 
of the complete OS version. This section describes the bundled packages and 
explains how to add or remove packages to create your own customized version of 


the Operating System. 


TECHNICAL REFERENCE AND FURTHER READING 

Provides technical specifications and information on the SPARCbook 2 computer and 
interfaces, including connector pinouts and cable details. It also provides a complete 
list of all the available technical documentation available from Tadpole and from 
third party publishers covering the SPARCbook 2 software. A summary of each 


manual is provided as a guide to help you select the ones you need. 


TROUBLESHOOTING AND PROBLEMS 
Gives a guide on what to do if things do not happen as you expect. This section 
provides a troubleshooting guide and information on how to tell what is wrong, as 


well as information on support services and help hot-lines. 
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TYPOGRAPHIC CONVENTIONS 


¢ SOLARIS 1.0.1 BUNDLED COMMAND SUMMARY 
Gives an alphabetical list of the commands available on the SPARCbook 2 version of 


Solaris 1.0.1. 


TY POGRAPHIC CONVENTIONS 


A number of typographical conventions are used in this guide. These allow you to distinguish easily 
between User Guide text, examples of the SPARCbook 2 responses and screens, and those cases 


which require you to enter keystrokes or move the cursor on the SPARCbook 2. 
Emphasis 


/talics are used for Topic titles and for emphasis. For example: 


The Disk LED is on when internal hard disk drive is being accessed. 


Solaris Command and Display Entities 


Information displayed on the SPARCbook 2 screen by the Solaris Operating System is shown in 
one of two ways. Either a picture of all or part of the screen is shown, or Courier font is used. 


Courier is also used to describe system utilities and commands. For example: 
The mail system will inform you when there is incoming mail from another user. 


you have mail 


Bold Courier is used in examples to show what you type in a particular situation. For example: 


To report the current time and date you should use the date command: 


% date 


o 


Remember that in order to have the SPARCbook 2 act upon your commands, you should normally 
press the Enter key at the end of each line. So, after typing date in the above example you would 


press the Enter key. 
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TYPOGRAPHIC CONVENTIONS 


Key Presses 


Key presses are shown in Times bold. Sometimes in the text you will be asked to press two keys, 
for example: 
Type Ctrl-D 


In this case you should press the Ctrl key down first and then, while holding the Ctrl key down, 


press the D key. 


You will also be asked to press several keys simultaneously. For example, when used with the Alt, 
Esc and O key combination (written as Alt-Esc-O) the word simultaneous actually implies the 


following sequence of actions: 
Press Alt 
While holding the Alt key down, press Esc. 
While holding the Alt and Ese keys down press O. 
Release O 
Release Ese 


Release Alt 


Choose and Select 


Two keywords are used throughout the guide to refer to the often used OpenWindows operations of 
Choose and Select. They are always shown with initial capitals. Choose is used to describe the act 
of picking a menu option or a selection from an OpenWindows menu. Select is used describe the 
act of initiating an action on a displayed item. These terms are described fully in “Basic Operations’ 


later. 
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TYPOGRAPHIC CONVENTIONS 


Notes and Warnings 


Notes are used to give you additional information on a subject. For example a note may refer to 


another part of this Guide. 


See ‘Backing up the Software’ for further information. 


Warnings are used to draw your attention to particular operating instructions which, if not heeded, 


may result in unexpected operation, data corruption or other adverse system behavior. For example: 


Do not attempt to install until you have followed the instructions below. 
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INTRODUCTION TO 
SPARCbook 2 


This section provides an introduction to the SPARCbook system. It describes the basic system, 
identifies the various components and explains how to set up the product. It describes the following 


basic operations. 


¢ Unpacking the SPARCbook 

¢ Opening the system 

¢ Installing the battery 

* Connecting the charger/adapter 

¢ Initially charging the battery 

¢ Turning the system on and off 

+ Starting the system for the first time 

« Adjusting the display brightness and contrast 
¢ Using the SPARCbook keyboard 

* Using the Mousekey 


The SPARCbook computer may be powered from the main supply or from the internal 


battery pack. Information on charging the battery pack is provided in this section of the 
User Guide. You may use the system while the battery is being charged from the main 


supply. 
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UNPACKING THE SPARCbook 


UNPACKING THE SPARCbook 


The SPARCbook system comes packaged in a single shipping carton. The packaging is in two 


sections and should contain the following items: 


¢ This User Guide 

¢ Bag with cables, license agreements, and other documentation 
¢ SPARCbook unit 

* Battery charger/adapter 

¢ Battery pack 

¢ Protective carry case 

* CD-ROM with Operating System software 


You should read the license agreements before you open the bag with the cables. By 
opening the bag you agree to the terms of the license agreement allowing you to use 
the SPARCbook system software. If you do not accept the terms you may return the 


SPARCbook system unopened in its original packaging for a full refund. 


The following cables are supplied: 


* Battery charger/adapter cable for country of purchase 
¢ SCSI interface cable 
¢ Video cable 


¢ Modem cable (USA model) 


If you have ordered any optional items these will be shipped in a separate carton with the 


appropriate documentation and packing list. 
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UNPACKING THE SPARCbook 


SPARCbook 2 Carry-Case 
CD-ROM Documentation 
(containing OS) 
9 
Charger/Adapter Power Cable 


Battery 


SCSI Breakout Cable 


Display Interface Adapter Audio Adapter Cable Phone Cable 


(For Sun Compatible Displays) 


OPENING THE SYSTEM 


OPENING THE SYSTEM 


Before opening the main system lid you should familiarize yourself with the outside of the system. 


The back of the system gives access to the I/O facilities and connectors behind a flap. 


== W000 


Serial SCSI Audio Modem 


Charger Keyboard/ Ethernet Video 
Mouse 
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INSTALLING THE BATTERY 


The system is opened by using your thumbs to slide the two lugs on the front of the unit outwards 


while simultaneously lifting the lid upwards. Adjust its position to obtain the best viewing angle. 


INSTALLING THE BATTERY 


The SPARCbook 2 is shipped with the battery packed separately and you will need to install the 
battery before using SPARCbook 2. To do this, ensure that the lid is closed and that the external 
supply is not connected, then open the battery flap by using a coin rotate the release by a small 


angle (less than a quarter-turn) in the direction of the arrow shown below, and while holding it in 
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INSTALLING THE BATTERY 


this position pull the flap release tab outwards The flap release tab is provided on new machines to 
allow you to open the flap without a battery in place, it would normally spring open. It can be 


discarded once the battery is installed. 


When shipping (as opposed to carrying) SPARCbook 2 it is advisable to remove the 
battery pack first, to eliminate any possibility of damaging the battery contacts if the 


system is dropped. 


i oN With the battery installed the battery door will open automatically under the pressure 
KOUE 
emeaiaian of the battery. 
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INSTALLING THE BATTERY 


To fit the battery, ensure that the metal contacts are inserted into the system first, and that the 
battery is oriented correctly (it can only be inserted one way round). Push the battery in until it is 
level with the door, and then close the battery door to seat it home. The door will automatically 


latch closed. 


oN You will not cause any damage to the SPARCbook by operating it from the external 
(NOTE > 
| 5 


adapter without a battery installed. However, doing this is not recommended since it 


may cause unreliable operation. 


Caution - Batteries may explode if mistreated. Do not short circuit the battery contacts 
or allow them to come into contact with metal objects. Always fit the battery end cap 
when the battery is not fitted in the SPARCbook 2 system. Do not mutilate the battery 
or dispose of it in a fire. Do not attempt to recharge the battery other than in the 


SPARCbook or with an approved battery charger. 
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POWERING SPARCbook 2 EXTERNALLY 


POWERING SPARCbook 2 EXTERNALLY 


The rechargeable battery in the SPARCbook is fully charged when shipped. You should connect 
the charger/adapter to the SPARCbook to recharge the battery when necessary. You may use the 


computer while the battery is charging, but charging will take longer. 


¢ The typical charging time with the computer off is 2.5 hours. 


¢ The typical charging time with the computer on is 6 hours. 


First plug the charger/adapter jack into the corresponding connector at the back of the SPARCbook 
system. Then plug the charger/adapter cable into the 3 pin IEC connector on the charger/adapter 


and into the wall socket or distribution panel as shown in the illustration. 


The lamp on the Supply Adapter should illuminate, showing that the adapter is operating and is 


charging the battery. 
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SWITCHING ON 


The charger will only fast charge if you plug it into the SPARCbook 2 and then into the 


main supply. If the main supply is already connected when the jack is plugged into the 
SPARCbook the battery will only trickle charge. In either case the SPARCbook will 
automatically detect when the battery is fully charged. You cannot do any damage to 
the computer by leaving the supply connected. Refer to ‘BATTERY CHARGING’ on 


page 139 for further information. 


SWITCHING ON 


SPARCbook 2 is switched on using the green ON switch above the keyboard. This is the only way 


of switching the system on. 


[NOTES > The ON switch is only used to turn the SPARCbook ON. It does not turn the computer 
he 


off. The switch has no effect while the system is running. 
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SAVE AND RESUME 


SAVE AND RESUME 


The SPARCbook is switched off by pressing Alt-Esc-O; these are labelled in Italics to help you to 
remember them. This uses the SPARCbook 2’s ‘Save and Resume’ feature to save the current state 
of the system automatically (even in mid application) and then power down. The SPARCbook 2 
will continue to operate with the disk spinning for up to 45 seconds (depending on the amount of 
memory) while it saves the complete system state to the hard disk drive, and will beep before 
powering down. The system may be moved while it is turned off. When the system is switched 


again on it will automatically Resume the exact state it was in when it was last turned off. 


While the SPARCbook internal disk drive is specifically designed to be used in 
portable systems, it is advisable to keep the SPARCbook stationary while the disk is 
spinning. Sharp knocks to the system may result in damage to a running disk drive and 


possible unrecoverable loss of data. 


RESET 


If there is a hardware or software problem with the system it is possible that pressing Alt-Esc-O 
will not actually turn the system off. In this event it is possible to reset the system manually by 
using the reset key sequence of Alt-Esc-R. This will cause the system to be reset immediately and 
to restart the system software. Diagnostics and Automatic system checks will be carried out to 
ensure no corruption has occurred, and after the system has reinitialized the prompt for logging into 


the system should appear. You may then turn the system off in the normal way. 


You should only press Alt-Esc-R when you want to reset the system. If you perform 
this operation during normal system use, the file system will be corrupted and will 
require repairing. You may also lose files that you were working on at the time. In an 


extreme case you may need to rebuild the file system on the disk. 
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SYSTEM START UP 


SYSTEM START UP 


When the SPARCbook is switched on, an automatic start-up sequence is entered. The automatic 
start-up runs a brief set of diagnostics to ensure correct operation of the SPARCbook hardware. 
These diagnostics are run while the disk is spinning up every time the machine is switched on. 
More extensive diagnostics can be run manually if you suspect a problem with the SPARCbook 2 


system. 


Further information on the diagnostics available can be found in the chapter 


‘TROUBLESHOOTING AND PROBLEMS’. 


When starting up for the first time (and after a Restore or Reload operation) the system will 
automatically ask you to supply information for basic configuration. These steps are described in 
the chapter ‘CONFIGURING SPARCbook 2’ on page 37. 


SCREEN BRIGHTNESS 


The SPARCbook uses a Cold Fluorescent (CFL) backlight to provide full screen legibility under a 
range of lighting conditions. The screen text should be clearly visible about 1 second after 


switching the machine on. If necessary the brightness may be adjusted from the keyboard. 


The Brightness controls can be changed at any time. The current values are stored and 


are automatically reused when the SPARCbook is switched on again. 


Screen brightness is controlled by two keys on the bottom right hand side of the keyboard. The Alt 


key must be pressed at the same time as the relevant control in order to have an effect. 


Pressing Alt key and * Increases Brightness 
Pressing Alt key and + Reduces Brightness 


The Operating System has facilities to enable you to turn off the backlight when the 


screen has not been used for a time. Nevertheless, a higher the brightness will draw 
more power from the battery. Running SPARCbook 2 with minimum screen brightness 


will extend battery life considerably. See ‘Power Management’ for further information. 
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THE KEYBOARD 


THE KEYBOARD 


The SPARCbook uses a keyboard with 82 keys to provide the maximum number of full-size keys 
within the space constraints of a notebook system. These keys have been laid out to be easy to use 


and several specific facilities have been incorporated. 


¢ Function Keys 
The twelve function keys can additionally emulate two further banks of function keys 
called Left and Right. Pressing the Alt key (also marked L) and a function key 
provides the Left function, while pressing the Fn key (also marked R) and a function 
key provides the Right function. These Left and Right function keys are required by 


certain SPARC software applications. 


¢ Special Function Keys 


The Alt and Fn keys are used to access certain special operations, as shown below: 


Alt-Esc-O Turn System Off 
Alt-Esc-R Reset Hardware 
Alt-H OpenWindows Help 
Alt- & Increase Brightness 
Alt- + Reduce Brightness 
Alt-PgUp Zoom In 

Alt-PgDn Zoom Out 
Alt-F1-Del Quit OpenWindows 
Fn-J Compose 


The Fn key is also used for Mousekey operations (see the next section). 


Fn-M Toggle Mouse Mode 
Fn-Ctrl Left Button (Select) 
Fn-A Middle Button (Adjust) 
Fn-S Right Button (Menu) 
Ctrl-Fn-Backspace Control-Select 
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By default, specific function keys are used for OpenWindows functions. 


F8 Cut 
F9 Copy 
F10 Paste 
Fll Next 
F12 Prev 


¢ Backspace and Delete Keys 
The Solaris Operating System can be configured to use different keys for different 
functions. By default, the erase or rubout key is the Del key. The interrupt key, used 


to quit an application, is the Ctrl-C sequence. 


Lee N This keyboard description assumes that the SPARCbook 2 has a US keyboard layout. 
NOTE 7 : aes ' 
: 


Information about non-US keyboards is provided at the rear of this guide. 
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THE MOUSEKEY 


SPARCbook 2 features a special key called the Mousekey. While a conventional mouse may be 
plugged into the unit for desk top use, the Mousekey has been designed for lap top use. When used 


in conjunction with some other keys, it emulates the functions of a three button mouse. 


Fi2 PrtSc| | Pause 
Prev 


The Mousekey is located on the top right hand corner of the keyboard. It does not depress in the 
normal way, but responds to pressure in any direction. The mouse is only normally used when 
running the OpenWindows software and a demonstration account is provided to enable you to get 
used to the Mousekey operation (see ‘GETTING STARTED WITH OPENWINDOWS’ on page 52 
for further information). To move the cursor, you press lightly on the Mousekey in the direction 
you want the cursor to move. Light pressure moves the cursor slowly while heavier pressure moves 


the cursor faster. 
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The Mousekey detects the pressure you are using to determine how fast to move the 


cursor. The pressure needed to move the cursor is configurable with the rest of the 


system setup and is described in the chapter ‘CONFIGURING YOUR DESKSET 
ENVIRONMENT’. 


The Solaris OpenWindows environment supplied on SPARCbook is based on the industry standard 
OPEN LOOK Graphical User Interface. This interface uses mouse buttons for selecting and 


dragging, and for displaying menus. 


Ctrl A S 


Select is used to select a choice, window or object. 
Adjust is used to extend or reduce the number of selected objects. 
Menu is used to display a menu or a set of choices. 


The SPARCbook uses several keys to emulate the operation of these buttons in one of two user 
selectable modes. 


The SPARCbook Operating System software does not enable the Mousekey facility 


until you have entered the OpenWindows environment. “THE DESKSET USER 
INTERFACE’ chapter explains how to start-up the SPARCbook and how to practise 


using the Mousekey. 
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Normat Mode 


In this mode, the three mouse button keys are used in conjunction with the Function (Fn) key to 
operate as mouse buttons. For example to press the Left Mouse Button (used for the Select 


operations) in normal mode you would use the Fn-Ctrl key sequence as follows: 
Press the Fn key with the thumb of your left hand and hold it. 


While keeping the Fn key depressed, press the Ctrl key to simulate pressing the Left 


hand mouse button. 


Release the Ctrl key while keeping the Fn key depressed to simulate releasing the 
Left hand mouse button. In the case of a Double-Select operation, press and release 


the Ctrl key again, while still keeping the Fn key depressed. 
Finally, release the Fn key when to completed the required mouse button operation. 


The Fn-Ctrl, Fn-A, and Fn-S key sequences behave exactly as the three mouse buttons, and you 
can use them exactly as you would a normal mouse. For example, in this guide ‘pressing Select’ is 


used to mean pressing the Fn-Ctrl key sequence. 


Some applications require you to press the Ctrl key while pressing Select. This action 


is achieved by pressing Ctrl-Fn-Backspace, i.e. Ctrl is pressed first and held, then Fn 


is pressed and held and then Backspace is pressed. 


Mouse Mode 


Many applications use Select for the majority of mouse based operations, and some use Select for 
all mouse operations. The Mouse mode allows you to reconfigure the Backspace key (to the left of 
the Mousekey) to function as the Select button. In this mode, Ctrl-Backspace is used if the 
application requires the Ctrl-Select operation. As before the Ctrl, A and S keys can still be used as 


all three mouse buttons in conjunction with the Fn key. 
You can toggle between Normal mode and Mouse mode by using the Mouse mode key sequence: 


Press Fn-M to toggle between Normal Mode and Mouse Mode 
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FRONT PANEL LEDs 


SPARCbook 2 uses four LEDs located to the left of the built-in display to signal system status to 


the user. These are illustrated below. 


Supply 

Disk 

User 

Battery Low 


The Supply LED 


The Disk LED 


The User LED 


The Battery LED 


illuminates when you power the SPARCbook 2 system from the 


external power supply. 


illuminates to indicate that an access to an internal hard disk is 


in progress. 


illuminates by command from Solaris Operating System. It is 
normally assigned as a Caps Lock indicator but may be 
reassigned, as described in ‘CONTROLLING THE USER 
LED’ on page 264. 


flashes to indicate that the battery needs to be recharged. When 
there is about 20 minutes of charge remaining. Unless you 
connect the external power supply, the SPARCbook 2 will 
automatically save the machine state to disk and shutdown. This 
feature may be disable, see-EXTENDING BATTERY LIFE’ 
on page 141. 
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THE NOMADIC COMPUTING ENVIRONMENT 


Several features have been incorporated into the SPARCbook 2 hardware and operating system 
software to form the Nomadic Computing Environment™ . Developed by Tadpole Technology, the 
Nomadic Computing Environment is integrated into the Solaris Operating System already loaded 
onto the SPARCbook 2 to provide mobile computing while allowing you to keep in contact with 
your base. The Nomadic Computing Environment comprises three basic elements: Portable System 


Enhancements, SPARCbook OS Lite and the Portable Network Environment. 


Portable System Enhancements 


Portable System Enhancements provide operating system protocols and servers to support the 
nomadic applications environment, and an operating system layer to make the nomadic features 
independent of the underlying industry standard network and communications protocols. Portable 
System Environment includes Save and Resume, Automatic Low Battery Save, Power 


Management and Portable Power Windows. These are summarized below. 


« SAVE AND RESUME 
The Save and Resume feature provides SPARCbook 2 with an automatic mechanism 
for stopping and starting the Solaris Operating System and active applications, 


without lengthy shutdown and start-up delays. 


¢ AUTOMATIC LOW BATTERY SAVE 
Automatic Low Battery Save protects against operating system and file corruption 
caused by interruption of the external power supply or by an exhausted battery. 
SPARCbook 2 switches to the internal battery automatically when the external power 
supply is disconnected. When the battery is nearing exhaustion, Automatic Low 
Battery Save saves the complete machine state to the disk before powering down. All 
you need to do then, is replace the battery or connect the external power supply 
(which also recharges the battery) and press the ON switch for SPARCbook 2 to 


Resume to its exact state when the Automatic Low Battery Save occurred. 


« POWER MANAGEMENT 
Power Management provides a set of system features, and a DeskSet tool which 


allows you to influence battery life. For example, you may elect to stop all 
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peripherals automatically when they are not in use, or you may run the processor 
clock at half speed. The chapter ‘Power Management’ provides more information 


about these features. 


* PORTABLE POWER WINDOWS 
Portable Power Windows is the SPARCbook implementation of OpenWindows V3 
optimized for application compatibility and portability. It provides external display 
resolution options, real-time panning and allows standard Sun applications to run 


with the SPARCbook’s internal display technology. 


SPARCbook OS Lite 


SPARCbook 2 is shipped preloaded with the Solaris Operating System (referred to as the ‘factory 
load’) that meets the SPARC Compliance Definition (SCD) and occupies about 50 Mbytes of disk 
space. The entire Solaris 1.0.1 Operating System for SPARCbook 2 is supplied with each unit on 
CD-ROM along with an optional end-user version of the Solaris Operating System called 
SPARCbook OS Lite. 


SPARCbook OS Lite consists of an optimized UNIX kernel, includes OpenWindows V3 with 
DeskSet V3 tools, and the other Nomadic Computing Environment tools, and occupies only around 


36 Mbytes of disk space. 


Portable Network Environment 


The Portable Network Environment provides a comprehensive set of applications and utilities to 
enable you to use the normal operating system facilities while away from your base location. This 


consists of Portable Productivity Tools. 


* PORTABLE PRODUCTIVITY TOOLS 
This suite of tools includes FAXtool, POPtool, SLIPtool and TZtool. FAXtool allows 
you to use the SPARCbook 2’s internal modem to send and receive fax messages. 
POPtool is a portable implementation of Post Office Protocol V3 which allows you to 
send and receive mail from your base network via a server. SLIPtool is a facility that 
allows you to establish a connection with a remote network and then access the 


remote network using any of the TCP/IP facilities as if directly connected via 
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Ethernet. Finally, TZtool is a facility which allows you to update the SPARCbook 2’s 


clock to the correct local time. 


OLE In addition to the communications tools introduced here, SPARCbook 2 
NOTE 
vei provides an extensive implementation of standard DeskSet tools. These are all 


described in detail in the chapter ‘THE DESKSET TOOLS’. 
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SPARCbook 2 


This chapter explains how to start the SPARCbook 2 up and how to personalize the operating 
system software to meet your own requirements. It covers the basic system configuration procedure 
carried out when you power the SPARCbook for the first time, describes how to set up a host name 
for your machine, how set the correct time and how to perform the initial configuration of the 


SPARCbook for a network. It also discusses how to set up user accounts. 
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BASIC SYSTEM CONFIGURATION 


The SPARCbook computer system must be initially tailored to your own requirements. This section 
describes how to customize the SPARCbook system. You can change the system configuration at a 
later date if you need to alter some of the information supplied. When the system is first turned on 


the following messages are shown: 


SPARCbook-2 Monitor 1.0 
Serial Number: 210029 
DRAM Size : 64 Mb 


1> Continue with automatic system startup 
2> Boot operating system or file 

3> Standalone Restore 

4> System Administration 

5> System Diagnostics 


Enter Choice> 


NOTE The Monitor version number and your own serial number will differ from the example 
above. Menus may differ slightly in later versions of the Monitor from those illustrated 
in this Guide. You should refer to the Solaris 1.0.1 Release Notes enclosed with all 
SPARCbook 2 units which provide additional information available since the 


SPARCbook 2 User Guide was published. 


After the operating system has loaded into memory the screen will clear and display the following 
messages. The exact format of the start-up messages depends on your system configuration. 
SUNOS 4.1.2 (SPARCbook) 


Copyright (C) 1983-1991 Sun Microsystems Inc 
Copyright (C) 1991-1992 Tadpole Technology 


Memory 8192K 
Ethernet Address 0:0:83:1d:0:0 


Mon Dec 30 14:12:20 GMT 1991 
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Hostname 


The SPARCbook will start the system configuration procedure. First you will be asked to assign the 
machine a unique name called a hostname. If you are using the system on its own this can be any 
convenient name, such as ‘sparcbook’. If you are using the system on a network you must make 


sure the name is unique and does not conflict with any existing machine names on that network. 


SYSTEM CONFIGURATION 
HOSTNAME 


If this system is connected to the network, the hostname must be 
unique to the local area network. Confirm this with your system 
administrator. 


Enter a name to assign to this workstation and press ENTER: 


Hostname => 
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Time Zone 


After you have entered your chosen hostname the system will request information about your time 


zone as shown below. If your time zone does not correspond to any of the areas shown you should 


select Greenwich Mean Time which allows you to select a time zone in hours relative to GMT. 


SYSTEM CONFIGURATION 
TIME ZONE 


Press <Enter> or <Space> to move forward to your choice and type x. 


* United States 

* Canada 

* Mexico 

* South America 

* Europe 

* Asia 

* Australia and New Zealand 

* Greenwich Mean Time 

[Ctrl-B] = Previous Screen[Ctrl-F] = First Screen 


The Time Zone information is used to set and determine the system time. If you intend 
to use your SPARCbook in multiple Time Zones you should set the Time Zone for the 
zone you are most usually in and then adjust the OpenWindows clock for different time 


zones when you travel using TZ Tool. This is described in ‘THE DESKSET TOOLS’. 


For example, if you select the United States a second menu will be displayed asking you to select 


the time zone you wish to use within the United States: 
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SYSTEM CONFIGURATION 
UNITED STATES 


Press <ENTER> or <SPACE> to move forward to your choice and type x. 


TIME ZONE NAME AREA 

US/Eastern Eastern time zone, USA 

us/Central Central time zone, USA 

US/Mountain Mountain time zone, USA 
US/Pacific Pacific time zone, USA 

US/Pacific-New Pacific time zone, USA 


with proposed changes to 
Daylight Savings Time 
near election time 


US/Alaska Alaska time zone, USA 
US/East-Indiana Eastern time zone, USA 
no Daylight Savings Time 
US/Hawaii Hawaii, USA 
[?] = Help [Ctr1-B] = Previous Screen [Ctrl-F] = First Screen 


After you have selected a time zone you will be asked to verify the system time. The system time is 


maintained by a separately powered clock device. 


SYSTEM CONFIGURATION 
SYSTEM TIME 


The system time is “Mon Dec 30 14:52:10 1991 PST”. 
Enter selection and press ENTER: 


1) Yes, accept that as current time. 
2) No, prompt me to input current time. 


Selection => 
[?] = Help [Ctr1-B] = Previous Screen [Ctrl-F] = First Screen 


If the time shown is correct, select option 1. If the time is wrong you will be prompted to enter the 
exact time. This will then be remembered by the system and you should not need to change it again. 


You may also go back a screen by typing Ctrl-B, or back to the beginning by typing Ctrl-F. 
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Configuring SPARCbook for a Network 


After the time has been configured the system will prompt for whether you are connected to a 
network. At this stage you should only say ‘yes’ if the SPARCbook is actually physically connected 
to a network interface. If the SPARCbook is not connected to a network then you should answer 


‘no’. 


For information about connecting the SPARCbook to a network refer to ‘Connecting to the 
Ethernet’. You will always be able to reconfigure the SPARCbook when you do actually connect it 


to a network for the first time if you decide to select ‘no’ for the moment. 


SYSTEM CONFIGURATION 
NETWORK 


Enter a selection for whether workstation is attached to a network 
and press ENTER. 


1) Yes, prompt for additional network questions to 
configure into network. 
(Verify Ethernet cable is attached to workstation. ) 


2) No, workstation is NOT attached to a network. 
Selection => 
[?] = Help [Ctrl-B] = Previous Screen [Ctrl-F] = First Screen 


If you select ‘no’ the next two screens will be omitted. The first prompts for the network address 
which will normally be assigned by the system administrator for your network. If you are setting up 
a network for the first time, or you do not know what your Ethernet address is, you are 
recommended to configure the SPARCbook for non-networked operation initially, and refer to the 
chapter ‘USING THE NETWORK INTERFACE’ for further information. 
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SYSTEM CONFIGURATION 
NETWORK ADDRESS 


You must assign a network address to your workstation. Contact your 
system administrator for the unique network address of your system. 
Do not use the displayed address (192.9.200.1) if your workstation 
is being connected to the Internet network. Do not enter an address 
unless you are sure it is correct. 


Enter the network address to be assigned to this workstation and 
press ENTER: 


Network Address (e.g. 192.9.200.1) => 
[?] = Help [Ctr1l-B] = Previous Screen [Ctrl-F] = First Screen 


After you have entered the address the system will ask you to specify if you are using the Network 
Information Service (NIS). This was known previously as Yellow Pages (YP). To use NIS you must 
know the domain name for your network. For more information on NIS see ‘INTERFACING TO 
AN EXISTING NETWORK’ on page 191. If you are not sure how to proceed specify ‘no’ to the 


use of NIS for the moment. 


SYSTEM CONFIGURATION 
NIS NAME SERVICE 


NIS is the network information service. 
Enter the selection that applies and press ENTER: 


1) Yes, the network uses NIS. Comfirm this with your 
system administrator. 


2) No, the workstation will not be using NIS. 
Selection => 
[?] = Help [Ctrl1-B] = Previous Screen [Ctrl-F] = First Screen 


If you choose to use NIS one further screen will be printed asking you to enter the domain name. 


Next, the system will summarize the information supplied so far and ask you to confirm it. If it is 


not correct you can use Ctrl-B to correct it, or Ctrl-F to start again. 
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Accounts and Passwords 


The next part of the system configuration procedure asks you to set up accounts and passwords. The 
Solaris Operating System is designed to be used in a range of system configurations from single 
user machines to mainframes. It therefore includes facilities to allow its use by different users. Each 
user signs on or logs in to the system by identifying an account name and (optionally) a password. 
A special account exists called the superuser or root account. This account has privileges and is 
used to carry out potentially damaging commands or system configuration procedures. A second 
special account is preinstalled and provides demonstrations of the SPARCbook. To set up the 


sir st configuration you will only nee S a single user account for your own use. 
mplest configuration you will only need to set up a single t for your own use 


First, you are asked to set a password for the root account. This is for security, as the superuser is 


able to access and change any user files as well as alter the system configuration and setup. 


Do not forget the password or you will not be able to use all the system facilities, and 


you will need to reload the operating system using the restore procedure. 


SYSTEM CONFIGURATION 
SUPERUSER PASSWORD 


For security reasons it is important to give a password to the 
superuser (root) account. A password should be six to eight 
characters long. To give a password to the root account, enter the 
password below. The password will not appear on the screen as you 
type it. 


Enter superuser password and press ENTER, or press ENTER to 
continue: 


Password => 
[?] = Help 


Next you will be asked if you wish to set up a user account. This procedure sets up a user account 
with a minimum of questions and should be used to set up your own account if you are not familiar 
with the SunOS Operating System. If you are an experienced user you may omit the next steps and 
use the superuser account to set up your required user configuration using 


/usr/etc/install/add_user or by editing the relevant system files. 
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If you have configured the system to use NIS you will not be prompted to enter user 


accounts. This is because user accounts are normally maintained on a single master 


machine on the network called a name server. Consult your system administrator or 
‘INTERFACING TO AN EXISTING NETWORK’ on page 191 for further 


information. 


SYSTEM CONFIGURATION 
USER ACCOUNT 


To use the system, a user account must be set up. You can set up 
the account now or separately after configuration. 


The following information is needed prior to setting up the 
account: 


User full name - the common name of the user, e.g. John Doe 
User name - the login name of the user, e.g. jdoe 
User id - the system numerical id of the user 


Do you want to set up a user account (y/n)? 
[?] = Help 


The User full name is used for certain system services such as electronic mail. The User name is 
what you actually type to login to the SPARCbook and to access the system. The User id is a unique 
number by which the network identifies this account. Numbers from 1-10 are reserved. You should 
obtain a number from your network administrator if you have one. If you are setting up a network 
yourself, or if the system is to be used stand-alone and you are not familiar with User ids it is 
recommended that you start at 100. Therefore, for the first account you set up use 100 as the User 


id, for the next 101, and so on. 


The next three screens prompt you for the required information. For example, to set up an account 


for a user called John Doe with a user name of jd you would enter: 


User full name => John Doe 

User name => jd 

User id => 100 
Note that the system will ‘suggest’ a user name based on your full name, in this case jdoe. You may 
use backspace to change this to the required user name if it is different. Next you will be asked to 


enter a password for the user. This is suggested but not mandatory. 


45 


BASIC SYSTEM CONFIGURATION 


SYSTEM CONFIGURATION 
USER PASSWORD 


Passwords are used for security reasons, but are not required. You 
can enter a password now, or you can also add one later. 


Enter the user password, and press ENTER, or press ENTER to 
continue: 


Password => 
[?] = Help 


After you have finished setting up the user account the system will complete its configuration and 
will continue with its boot sequence. The exact messages printed depend on the system 


configuration but the sequence shown below is typical for a networked system: 


Configuration successfully completed 
starting RPC key server 
network interface configuration: 
nid: flags=63<UP,BROADCAST,NOTRAILERS , RUNNING> 
inet 192.9.200.99 netmask ffffff00 broadcast 192.9.200.0 
ether 0:0:83:1d:0:1 
100: flags=49<UP,LOOPBACK, RUNNING> 
inet 127.0.0.1 netmask ££000000 
starting additional services: biod 
starting local daemons: auditd sendmail statd lockd 
loaded openwindows module 
clearing /tmp 
starting standard daemons: update cron uucp 
starting network daemons: inetd printer 
Mon Dec 30 17:00:08 GMT 1991 


sparcbook login: 


The messages indicate the various steps of the Solaris Operating System start-up. After the start-up 
the system is ready to use and the login prompt is displayed as shown. Assuming you have set up a 


user account you will now be able to login as one of the following: 
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root superuser account — displays the Solaris command prompt 
demo demonstration account — starts OpenWindows to provide demos 
<user> user account — if you have set up an account you will now be able 


to login as the user name you specified. 


You may change any of the settings you have provided in the system configuration 


procedure at any time by logging into the SPARCbook as root and typing the 
command: 

# /usr/etc/install/sys-config 
This will cause the first screen to be entered again allowing you to change any part of 
the previously set up configuration. You may restore the SPARCbook to its original 
unconfigured state by typing the command: 

# /usr/etc/install/sys-unconfig 


However, existing accounts will be retained. 


Unless you have access to a CD-ROM drive or a Sun workstation, it is strongly 
recommended that you back up the system software before using the SPARCbook. 
This will allow you to restore the factory load of the Solaris Operating System in the 


event of disk corruption causing a failure. 


Full instructions on how to make a backup via SCSI or over a network are provided in 


the chapter ‘BACKUP AND RESTORE’. 


SYSTEM SECURITY 


Being designed for portability, the SPARCbook 2 notebook computer can be particularly vulnerable 
to theft. Theft of your SPARCbook system, while being a serious enough occurrence in itself, may 
not be as serious as unauthorized access to the data stored within your system. The SPARCbook 2 
resident firmware provides a system security mechanism which allows you to password protect 
your SPARCbook against unauthorized use. When activated, protection is provided by a User Key 
which must be entered before the system can be started. A Maintenance Key may also be used to 
allow the User Key to be bypassed in the event that the User Key password is forgotten, of if the 


system is returned to the factory for repair. 
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The User Key should not be confused with the User Password used to protect a Solaris account, 


which provides protection for one account only but still allows the SPARCbook 2 to be powered up. 


When a User Key has been programmed, all system start-up or Resume sequences are interrupted 
with a prompt. If the correct User Key is not entered within five attempts, the SPARCbook system 
powers down. If you press Ese while the User Key prompt is being displayed, the SPARCbook 2 

prompts for a Maintenance Key. A valid Maintenance Key must be entered within two attempts or 


the SPARCbook 2 system powers down. 


The Maintenance Key facility is provided so that you can recover if you forget your 
User Key, allowing you to start up the SPARCbook and remove or change your User 


Key. You should contact your SPARCbook dealer if you require a Maintenance Key. 


The Maintenance Key function can be disabled to provide increased system security, 
but if the User Key is forgotten, the SPARCbook unit will have to be returned to the 


factory for reprogramming. 


The SPARCbook 2 is shipped from the factory without a User Key programmed and with the 
Maintenance Key active. To change these settings you should restart the SPARCbook and then 
press any key to display the start up menu. Select option 4, System Administration, and then from 
the System Administration Menu select Configure Security Key. The following menu will be 


displayed. 


1> Set User Key 

2> Disable Maintenance Key 

3> Enable Maintenance Key 

4> Deactivate Maintenance Key 


Set User Key 
This option prompts you to enter a new User Key. The key should 
be at least six characters in length and may contain any 
combination of letters and numbers. You should note that User Key 
protection is case sensitive so that, for example, SPARCbook2 and 
sparcbook2 would be different. Be particularly careful to note 
whether the Caps Lock key is active, indicated by the green User 
LED next to the LCD display. 
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The key must be entered twice to ensure that you do not enter a key 


containing typing errors. 


If you wish to remove an existing User Key, press Enter when 


prompted for a new key. 


Disable Maintenance Key 
Allows you to turn off the Maintenance Key. When the 
Maintenance Key is disabled there is no way to get round the User 
Key, if you have entered one. This makes your system more secure 
but if you forget your User Key the SPARCbook 2 system will have 


to be returned to the factory for repair. 


Enable Maintenance Key 
Allows you to turn on the Maintenance Key. If you have 
programmed a User Key, this is only possible after you have started 


the SPARCbook with the correct User Key. 


Deactivate Maintenance Key 
When you start the SPARCbook 2 with a valid Maintenance Key, 
all system security is turned off until the end of the day. Once you 
have changed your User Key you should make your system secure 


again by selecting this option. 
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THE DESKSET USER 
INTERFACE 


The SPARCbook 2 system software provides a user-friendly Graphical User Interface called 
OpenWindows Version 3. This chapter provides an introduction to OpenWindows Version 3 as 


provided on SPARCbook 2. The OpenWindows Version 3 Facilities include the following: 


¢ DRAG AND DROP 
Ability to move data between applications by ‘dragging’ a pictorial representation of 


data and ‘dropping’ it onto an application. 


* DESKSET USER INTERFACE TOOLS 


Virtual Window Manager For running multiple applications 


File Manager For moving and manipulating files 

Mail Tool For using electronic mail 

POPtool For electronic mail access 

Print Tool For printing files 

Calendar Manager Diary and calendar software 

Text Editor Simple document editor 

Faxtool For sending and receiving faxes using the modem 
Command Tool Terminal interface to Solaris 

Clock For time keeping 

Calculator For mathematical calculation 

Tape Tool For using tape drives connected to the SCSI 
SLIPtool For remote access to a network 

TZtool For changing the system time to suit the local time zone 
Power Manager Controls for influencing battery life 


¢ CONFIGURABILITY 
Add new applications and commands 


Set user preferences 
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This section can only provide a brief introduction to the OpenWindows environment 


and facilities. For further information please refer to the optional full documentation 


on the Graphical User Interface. 


GETTING STARTED WITH OPENWINDOWS 


SPARCbook 2 provides an account called demo which uses the OpenWindows environment. It 
provides: a Mousekey demonstration, to allow you to become accustomed to working with the 
Mousekey; an OpenWindows tutorial; and some demonstration programs. While you can call this 
tutorial up at any time, the demo account allows you to experiment with the Mousekey and with 


OpenWindows. 
To login to the demo account you simply type demo at the login prompt: 


sparcbook login: demo 


The system will automatically start up the OpenWindows environment which takes about 30 
seconds to initialize. After this time a screen will appear giving a set of demonstration choices as 


shown below. 


sete tienen 
demotaal 


SPARCbooK Demonstrations 


Mousekey Demo 1 ) 
Openwindows Tutorial 2 ) 
Run Demos = 3} 


_Exit } 
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Mousekey Demonstration 


If you are using SPARCbook 2 for the first, time you can experiment with the Mousekey by 
selecting the Mouse option. To start the demonstration type 1 and then press Enter. After the 
program has loaded, a mouse representation and a grid of lines will be drawn. Pressing a mouse- 
button key sequence on the keyboard will cause the corresponding mouse button on the display to 
change color. Pressing the Mousekey will move the cursor (cross or pointer), and you should 
practice moving it around. Refer to ‘THE MOUSEKEY’ on page 30 for further information on 


using the keyboard mouse. 


mousedemo 


By default in OpenWindows, the mouse is constrained to move in four directions only (vertically or 
horizontally). This makes it easier to move the mouse down and across menus in the OpenWindows 
environment. It is possible to change this to eight-way constraint (with diagonals allowed), or to 

completely unconstrained, as with a normal mouse. To change the default mode, move the pointer 


to the required mode and press Select. 


To exit the Mousekey demonstration move the pointer to the Exit box and Select it. 
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OPENWINDOWS TUTORIAL 


To run the tutorial select Option 2 by typing 2 and then pressing the Enter key. Note that the 
tutorial is part of the Solaris Operating System and assumes you are using a normal mouse. When 
mouse operations are specified, you will need to perform the corresponding operations with the 
Mousekey. In addition, reference is made to the system Help key. On a Sun workstation this key is 
located on the bottom left hand side of the keyboard. On SPARCbook 2, the same function is 


simulated with the Alt-H key sequence. 


You may also use a conventional mouse with SPARCbook 2. For further information 


refer to ‘CONNECTING AN EXTERNAL KEYBOARD AND MOUSE’ on page 158 


USING OPENWINDOWS 


OpenWindows will be started by default when you login to SPARCbook 2, if you set up your user 


account during the system start-up. The following message will be displayed: 


sparcbook login: yourname 
SunOS 4.1.2 (SPARCbook) 
Starting OpenWindows (Type Control-C to interrupt) 


OpenWindows will take about a minute to start-up. 


If you are in a Solaris shell (this is the normal command interface to Solaris and is typically 
signified by a 3 or a $ prompt) you may start up OpenWindows by entering the openwin 


command: 


% openwin 


The picture shows the default environment shipped as standard. Later you will be able to change 


this default setup to suit your own preferences. 
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USING OPENWINDOWS 
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BASIC OPERATIONS | 


The Workspace is the entire screen. One or more applications may be run and these may occupy 
some or all of the Workspace. A typical workspace is shown below; the different items that can 


appear on the workspace and how they are used are discussed next. 


ia cmdtool (CONSOLE) - /bin/csh y = [clock yy =| Virtual Desktop 
printtool; No printers found in fetc/printcap ee 2 - ‘aa a _ 
+ 


¥ File Manager ¥3 : /usrfexport/home/juno/ds 


File 7) View ¥) Edit 7} Props ¥) Goto: T)e _ 


Workspace_1 
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Menus and Mouse Buttons 


SPARCbook 2 keyboard uses the Mousekey and Fn, Ctrl, A and S keys to simulate operation of a 
three button mouse, see ‘THE MOUSEKEY’ on page 30. 


The effect of each button depends on the context in which it is used. As a general summary the 
following rules apply; although the exact use of each button depends on the application being run at 


a particular time. 


Select is used to select a choice, window or object. For example, it has no effect when pressed in the 
screen background since there is nothing to select, but if it is pressed while the pointer is inside a 
window that window becomes Selected. Window selection is shown by the filled in border at the 
top of the window. The Selected window is the one which you are using; all keyboard input will be 


directed to that window. 


cmdtool (CONSOLE) - /bin/csh 


ping mac-ds 
is alive 


cmdtool - /bin/csh | 


qun F : = —— omen 
7 | cmdtool — /bin/csh 


juno ‘hoard input is to the selected window 
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You can also use Select to cut and paste text from one place to another (in the same or different 
windows). For example, if you press Select and while holding it down drag the pointer (using the 
Mousekey) across a line of text that line will become highlighted, showing that it is Selected. 
Another operation may now be performed on this line (it may be cut, or in a desktop publishing 
application, have its font changed). Some operations, for example starting an application from an 
icon, require that you press Select twice in rapid succession. This action is referred to as Double- 
Select. 


| San anata ene a nh mE SE ATES RES RN HY AEE ARTA LAS ARATE RAT 


Text Editor ¥3 - Text_example (edited), dir; /ust/export/home/ju | 


File VIEW Edit Find 


By holding the Select key down and dragging the pointer with 
the mouseke Te emAcross several 


another location of the workspace, 


Adjust is used to extend or reduce the number of selected objects. Using the same example as 
before, you could Select the beginning of a page of text to be marked and then press Adjust at the 
end of the page. This would have the same effect as dragging the cursor across the text with Select 


depressed. On completion of the operation the selected text will be highlighted. 


Menu is used to display a menu or a set of choices and to choose an option. When used within a 
window, Menu may have different meanings depending on the application. For example, pressing 
Menu with the Pointer in the title bar at top of a window displays the window menu. Pressing Menu 
on the background brings up the Workspace Menu. These menus are discussed in more detail later 
in this section. In OpenWindows, the Menu button symbol is an inverted triangle. Pressing Menu 
with the pointer over this button reveals a set of choices. To choose a menu option you should hold 
Menu down while moving the pointer to the option you want to select and then release Menu. If the 
pointer is moved off the menu area before Menu is released the menu will disappear and no action 


will be taken. 


58 


BASIC OPERATIONS 


File Manager ¥3 : fusr/exportfhome/juna/ds 
Workspace 


Programs 


Shaw Tree eas 
Utilities 


Properties... 


Icon by N ame 


Icon by Type calMan_2 Portable 
List by Name we Exit. 
NSS 


List by Type 
ue | CalMan_s CalMan_6 


List by Size 


List by Date 


Customize. 


Some menus offer more than one level of choices. This is indicated by a triangle beside the menu 
option. For example, the Workspace Menu Programs option has a second level menu. To reach a 
second level menu keep Menu depressed and move the pointer across the menu option in the 
direction of the triangle. The second level menu will appear allowing you to choose an option as 


before. 


Pressing and releasing Menu rapidly causes a menu to stay in place. The arrow keys on the 


keyboard may then be used to move though the menu choices, and the Enter key to choose an item. 


As shown in the picture above, some menus have a defau/t option, shown by a round cornered box 
surrounding the default menu option. You can Choose the default option by releasing Menu when 
the pointer is over the menu name. For example, to Choose the Command Tool option you need 


only move the pointer to the Programs selection and release Menu. 


You should experiment with the Mousekey to Select objects and Choose from menu 


options. For the rest of this section the word Select is used to describe the operation of 
Selecting an object. The word Choose is used to describe picking an option from a 
menu with Menu. For further information on the Mousekey and how to use the 


simulated mouse buttons, refer to ‘THE MOUSEKEY’ on page 30. 
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Workspace Menu 


The main Workspace menu is accessed by moving the pointer anywhere on the workspace where 


there are no windows (the workspace background) and pressing Menu. 


worksp Programs 


Command Tool. 


Prograrns 


Utilities Text Editor. 


Properties. File Manager. 


Mail Tool. 


Portable 
Calendar Manager... 


Exit. 


Clock. 


Calculator. 
Print Tool... 
Fax Tool. 
Floppy Tools 
Tape Tool. 
Snapshot... 
Performance Meter. 
Shell Tool. 
Audio Tool. 


Demos 


¢ Programs 
This option has a second level menu that allows easy access to a range of programs 
and applications supported under the OpenWindows. You can customize this menu to 


your own requirements, see “CUSTOMIZING OPENWINDOWS MENUS’ on 


page 132. 


° Utilities 


Described in ‘UTILITIES’ on page 135. 


¢ Properties 
Described in ‘WORKSPACE PROPERTIES’ on page 130. 


¢ Portable 
This option has a second level menu. This provides access to: battery status and 
power management facilities; external keyboard and mouse controls; external display 


controls; POPtool; SLIPtool; and TZtool.. 
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° Exit 
If you Choose the Exit option all OpenWindows applications will be exited and you 
will be logged out or returned to the shell prompt depending on how your account is 


configured. 


Windows 


OpenWindows uses rectangular screen areas called Windows to allow multiple applications to be 
used at the same time. The Window format conforms to the OPEN LOOK style guidelines which 
ensure a common ‘look and feel’ between different applications. As in the Apple Macintosh or MS- 
Windows environment, once you have learned the basic operations it is simple to use any 


conforming application. 


er tntntetnnennnnttnttatentnntnnsneentinittetitttinn ih rte nn 
cmdtool (CONSOLE) - /bin/csh 


ndar Ma 7 ds@j 
Calen hager ¥3: ds@juno Desktop 


CM Appointment Editor 


Januar 


Date: 1/26/93 


; : Appointments Tesxt_examp 
Month / Day # 


Start: 3:00 


End: 10:00 


What: , AudioTool 


| Appt ToDo) My Eyes only 


Beep 
Repeat: None 
Flash 
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Popup 


Mail 


Delete Change Clear Restore 5ize 
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w 


Clase 


Full size 
Move 
Resize 
Properties 
Back 
Refresh 
Stick 

ouit 


Each Window has an associated menu which may be reached by selecting the menu pointer on the 


top left hand corner. To display a Window menu move the pointer to the menu symbol and press 


Menu. The window menu will be displayed offering the following options. 


Close 


Full Size 


Move 


Resize 


Properties 


Back 


Refresh 


Stick 


Quit 


changes the window into an Icon. 


changes the window to take up the entire screen. You can also do 
this by Double-Selecting on the top border of the window, and 


reverse this by Double-Selecting the top of the window again. 


moves the window with the cursor keys. Windows may also be 


moved with the mouse (see ‘Resize Corners’ on page 63). 


allows you to resize the window with the cursor keys as for move. 


Windows may also be resized with the mouse. 


(if present) allows you to change the properties of a window. This is 


window and application specific. 
moves the window to the back of the Workspace. 


redraws the window (for example if the contents have been 


corrupted). 


determines whether the window will appear in every Virtual 
Window Manager frame or not (see the section ‘VIRTUAL 
WINDOW MANAGER’ on page 71). 


closes the window and causes the application to be exited. 
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Pushpins 


Pushpins are used on some menus and windows. They are used like pins on a notice-board. If you 
Select the Pushpin (using the Mousekey and Select) it will be inserted, and the menu or window 
associated with the pin will remain on the screen. If the inserted pin is Selected the pin will be 


pulled out, and the menu or window will disappear. 


Utilities 


Resize Corners 


Resize Corners are situated at the corners of windows. Using these corners you can change the size 
of a window. You can do this by moving the pointer to the corner you want to move, pressing 
Select, and while holding it down, dragging the corner to the required new position. When you 
release Select, the window size will be changed. Note that changing the area of a window does not 
change its scale, only the area of its contents that is actually displayed. If you want to move a 
window you can Select the window header (the bar at the top of the window) and drag it to the 


required new location before releasing Select. 


||| 
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Scrollbars 


On the right hand side of the window (and sometimes in other places) there may be a Scrollbar. If 
the application cannot display all the information in the available space the scrollbar can be used to 


display hidden information. Scrollbars have several different components. 


Top Anchor 


SLANT IAS | 


> 


Up Arrow 
Drag Area Elevator 
Down Arrow 


Bottom Anchor 


The Elevator indicates your position in relation to the available total viewable area. You Select 


various parts of the Elevator to move through the viewable area: 


¢ Select the Top Anchor Moves to the beginning 
« Select above the Up Arrow Moves up one page 
¢ Select the Up Arrow Moves up one line 


¢ Select the Drag Area and drag Moves to an arbitrary position 
¢ Select the Down Arrow Moves down one line 


« Select above the Down Arrow Moves down one page 


¢ Select the Bottom Anchor Moves to the end 
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Controls 


Controls and Control Areas are used to enter data, to select options or to adjust a parameter. For 
most controls the Mousekey is used to point at the required setting and Select is used to select or 


move the required option. 


LLLULEiL 


L 


t 
L 
PELL LiL. 


= —— 
i 
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A Text Field allows the user to enter text. To enter text the pointer should be moved to the text field 
and the field selected with Select. The text is then entered in the normal way from the keyboard, and 


terminated with the Enter key. 


Text:store 


Directory: /usr/exportéhome/juno/ds 


File: .File_name, 


Stare as New File 
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Icons 


In OpenWindows user files and applications have pictorial representations called icons. Different 
types of files have different icons. For example, Solaris Operating Systems directories are 
represented in the File Manager by the folder icon. Each folder contains further files. Some 


examples of icons are shown below. 


; sath xe “se 
‘Text_examp 


Windows that you are using may be converted into icons at any time. When applications are 
represented with icons they continue to operate, but you will not see any changes until you change 
the icon back to a window. Some applications change the icon if attention is required. For example 


the mail icon can take on three different forms. 


——— rmiailtool 
rv 


trailtoal mailtoal 


You can change a window into an icon by Selecting the Close button (the small inverted triangle) at 
the top left of the window. If you want to reopen the window you simply need to Double-Select the 
icon (by moving the Pointer over the desired object and then pressing Select twice in rapid 

succession). When this operation is carried out on an icon the associated window will be reopened 
where it was originally displayed. Remember that its contents may have changed if output was sent 


to the window while it was iconized. 
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Help 


You may request help at any time if you are not sure how to proceed. To request help on a topic, 
move the pointer to the object or area on which you would like help, and then press the Alt-H key 
sequence on the keyboard. A pop-up help window with the available help text will appear at the top 


left of the display. When you have finished you should remove the Pushpin by Selecting it. 


Note that additional help using the More button is not available in the bundled SPARCbook 


Operating System, since the on-line handbooks are not included. 


 olwm: Help 


Resize Corner 


Use the Resize corner to expand or contract the 
window: 


1, Move the pointer to any Resize corner, The 
pointer changes from an arrow to a circle, 


Pr SELECT and drag the pointer, The R 2 
corner is highlighted, A bounding box shows 


Data Function Keys 


Many applications allow you to copy, cut and paste text within or between windows. Using 
OpenWindows these operations are carried out using the same controls and operations as for basic 


manipulation of windows and objects. 
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To select an area for copying or cutting, you may use Select and drag over your required selection, 
or you may Select the start point of the required text and use Adjust to adjust the selection to the 


required end point. When you have selected an area of text it will be highlighted. 


=| Text Edito 


Y) View ¥) edit e) find vy 


CUT, COPY and PASTE keys 


The CUT, COPY and PASTE keys can be found on the FS, FS and FiO 
keys, YOU Can use them to move text and sounds between documents 
or applications. To Select text to be moved, use the SELECT key 
and drag, or mark the begginming with the SELECT key and the end 
with the ADJUST key, 


Selected text 15 highlighted in reverse Jaiihe 


This text can be cut or copied prior to pasting into a new 
location, 


Certain function keys have been preassigned for basic operations and are marked on the keyboard. 


Cut (F8) will remove the highlighted text. It is buffered in SPARCbook 2’s 
memory and may be copied to another place by using the paste 
command. By default it will be pasted onto the next command line 


if you are in a terminal window. 


Copy (F9) will copy the highlighted text into SPARCbook 2’s memory. It may 


be copied to another place using the paste command. 


Paste (F10) will paste any buffered text to the selected place. Thus to cut text 
from one window and place it into another you should perform the 


following operations: 
Select the text to be cut using Select and drag, or Select and Adjust operations. 
Press the Cut key. The highlighted text should now be removed. 


Select the new place to lay the text, with Select. 
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Press the Paste key. The text should appear in the new location. 


Next (F11) will make the next selection of a series. It is also used as the Next 


key for DOS applications. 


Prev (F12) will make the previous selection of a series. It is also used as the 


Prev key for DOS applications. 


Drag and Drop Facilities 


OpenWindows Version 3 provides the facilities to Drag and Drop objects in order to move data 


between one application and another. Some examples of Using Drag and Drop are as follows: 


Printing a File 


Deleting a File 


Running an Application 


CUE 


If the Print Tool is running you may print a file by 
Selecting the file from the File Manager window and 
dragging it (keeping Select pressed) onto the Print Tool 


icon. 


To delete a file you may Select the file from the File 


Manager window and drag it onto the Wastebasket icon. 


Many applications may be started by dragging the 
application icon from the File Manager onto the 
workspace (see “THE DESKSET TOOLS’). 
Alternatively you may be able to Double-Select the 


application to start it. 


Note that the object you are dragging will be highlighted with a ‘bulls-eye’ target when 


you are over an area that supports the drop operation. This is called the Drop Zone and 


helps to identify applications which support the Drag and Drop metaphor. 
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~ File Manager ¥3 : /usr/export/home/sparchki4/doc 


File View 7) Edit ¥ Props Goto: 


sp ar e 
ik 4 


Some DeskSet applications have drag and drop targets in their main windows. These are generally 
in the top right hand corner. When you drop an object onto the target it will be loaded into the 
application, replacing what is already there. For example, if you drop a file into the Text Editor drag 


and drop target, any text currently being edited will be replaced with the contents of the file. 
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In addition, some drag and drop targets are shaded indicating that the contents of the current 
application can be dragged out of the drop target. For example, to print the current contents of the 
Text Editor, you can Select the shaded area from the Text Editor and drag it onto the Print Tool icon 


drop target. 


Usrfexpornm/home/ju 


pointer with 
ross several 


File: | export‘h 


mee: SE : 


sted into Printers =) j.ugty 


VIRTUAL WINDOW MANAGER 


When you start up OpenWindows on SPARCbook 2, the default window manager is called the 
Open Look Virtual Window Manager or olvwm. This is a powerful tool to manipulate windows and 


is particularly useful on the limited screen size provided by a notebook computer. 


The Virtual Window Manager gives you a virtual workspace or virtual desktop that is bigger than 
the screen. By default it measures three screens horizontally by two screens vertically, but you may 
easily change this to suit your own requirements. The virtual desktop is represented by a small 


window that is by default situated at the top right hand side of the screen. 


| © | virtual Desktop | 


' 
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THE VIRTUAL DESKTOP 


To move the current view on the Virtual Desktop, you move the pointer onto the virtual desktop 
window and into the screen representation or panel you wish to move to and Double Select. The 
current view will change to the selected panel. For example, the picture shows the screen after you 


have moved to the bottom right hand panel. 


¥irtual Desktop 


Note that the virtual desktop window has moved with you into the new screen. This is because the 
virtual desktop window is sticky. A sticky window is one that will always appear in the same 
position in currentlt displayed panel of the virtual desktop. This is useful for applications that you 
always want at hand. For example, the clock program (which you can Select from the Programs 
menu) is configured as sticky by default. You may make any window sticky (or not) by choosing 


the Stick (or Unstick) option from the Window menu, see‘ Windows’ on page 61. 


Notice also that the virtual desktop window contains a scaled image of the entire virtual screen. 


Each scaled window also contains the first letters of the application name. 
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Using the virtual desktop you can start multiple applications in different screens on the virtual 
desktop and switch rapidly between them by Double-Selecting the panel you want to use in the 


virtual desktop window. 


You may also move round the virtual desktop using the cursor keys. To do this, first Select the 
virtual desktop window by moving the pointer to the window header (the bar on the top of the 
window with the title) and pressing Select. Then use the cursor keys to move a panel at a time up, 
down, left or right in the virtual desktop space. You may also move a half-panel at a time by 
pressing Shift and the relevant cursor key. The currently selected panel in of the virtual desktop is 


inicated in the virtual desktop window with a black border. 


Moving Windows on the Virtual Desktop 


Because of the space constraints of the notebook computer screen you will often want to use 
applications that use pages of a larger size than the screen. You may want to change the window you 
are viewing, or view another part of that window. Using the virtual window manager you can move 
windows quickly by moving their representations on the virtual desktop. For example, assume the 
initial window configuration is as shown in the section “USING OPENWINDOWS’ on page 54. 
This is the default for a new user. Using the Virtual Window Manager, move the File Manager by 
moving the pointer onto the representation of File Manager in the Virtual Desktop window and 
pressing Select. While holding Select down, drag the File Manager representation into the bottom 
right hand panel and release Select. The File Manager has now been moved to the bottom right 


hand panel and will disappear from the current view. 


a 
~| Virtual Desktop |] 


[ 


= 
Te 


To verify this you can move the pointer to the bottom right hand panel and Double-Select. Your 


screen will now show the bottom right hand panel containing the File Manager. 
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As a final example, move back to the top left hand panel by Double-Selecting it in the Virtual 
Desktop window. Using the Virtual Desktop in the same way as the last example, move the File 
Manager window, except this time move the pointer right out of the Virtual Desktop window. 
Notice that a border appears on the current screen. This is the File Manager window, and if you 
release Select it will be placed onto the current screen, and will be seen in the upper left panel of the 


Virtual Desktop window. 


Configuring the Virtual Desktop 


You may change the Virtual Desktop size by simply resizing the virtual desktop window. It may be 
resized in units of screen size. If you make it smaller than its current size you will not lose any 


windows on the ‘removed’ area. If you make it larger again they will reappear. 


The SPARCbook 2 keyboard by default has a function key dedicated to the virtual desktop. This 
key allows you to bring the Virtual Desktop window to the front of the screen at any time by simply 


pressing the F7 function key. 


If your application uses this function key you may reassign the key the Virtual 


KCVE 

os Manager uses by changing the ol vwm defaults file. See the chapter ‘CONFIGURING 
YOUR DESKSET ENVIRONMENT?’ for further information. 

[ee It is not possible to exit from the virtual desktop using the Quit option in the Virtual 

NOTES 


Desktop menu. To exit from the windowing system Choose the Exit option from the 


Workspace menu, see ‘Workspace Menu’ on page 60. 
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The DeskSet tools provide a set of applications to improve productivity and to make using 
SPARCbook 2 facilities as easy as possible. Tools are provided to manage windows, to send and 
receive electronic mail through the internal modem or over the network, to schedule appointments, 
and to edit and print text files. This chapter provides an introduction to the tools supplied as part of 
the SPARCbook 2 Operating System. 


This User Guide does not provide a complete Reference Manual for the Sun DeskSet 


tools. It does give an introduction to some major applications and shows you how to 
perform the most common tasks. The Commands Section gives a brief summary of all 
the various commands available in the DeskSet tools, but for a complete reference you 


will need to obtain the Sun DeskSet Reference Manual Set. 


Almost all of the functions and features in the DeskSet tools can be reached through the menus 
provided in the main window of each application. The DeskSet tools use common features and 
facilities and while not all the facilities can be documented in this introductory guide, you will 
quickly learn the available features by experimenting with the menu options available in each 


application. 
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FILE MANAGER 


The File Manager is a graphical representation of the file system in tree form. In the Solaris 
Operating System, files are contained in directories, which are shown as folders in the File 
Manager. In each folder can be files, applications or more folders. The file system consists of a 


hierarchy of folders which form an inverted tree. 


If the File Manager is configured to be run when you login, it will display a window showing your 
own directory tree. If it is not configured to be started automatically, you can start a File Manager 
by Choosing the File Manager option in the Workspace menu. To do this, move the pointer to a free 
area of the workspace and press Menu. While holding Menu down, move the pointer to the 
Programs option and then the File Manager selection. Release Menu and the main File Manager 


window will appear. 
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Each File Manager window contains two areas or panes. The top pane shows where you are in the 


entire SPARCbook file system tree, while the lower pane shows the contents of the current folder. 


File Manager ¥3 :/home/juno/ds 
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Moving Dragndrop_2 


Each file in the file system is represented by an icon. There are three types of icon used for the 
majority of files. A folder is used to represent a directory of files, sheets of paper, or icons 
determined by the application, represent text and other ASCII data files (for example spreadsheets 
or graphical output files) and applications themselves are represented as a small window, or as an 


icon representing the application itself. 
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The File Manager allows you to perform the following operations on selected icons: 


¢ Open files, folders and applications 
¢ Create new files and folders 
* Move and copy files, folders and applications 


¢ Link files so they can be accessed from more than one folder 
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As before, you can select one or more icons by using the pointer and Select, and then dragging the 
pointer or using Adjust if you want to select more than one icon simultaneously. Each selected icon 
is highlighted. You carry out operations by using the Mousekey to drag and drop icons on other 
icons in the File Manager, or on other windows, or on the workspace itself. Alternatively you can 
use the File Manager menus to carry out the same operations. Finally, you can Double-Select an 


icon to open it. The effect depends on the icon itself: 


¢ For an application, the application will be started 
¢ Fora folder, the folder will be opened and its contents shown in a pop-up Window. 
¢ Fora data file, the corresponding application will generally be opened. If there is no 


known corresponding application, the text editor will be opened to edit the file. 


Copying Files 


Files can be moved and copied by selecting them and dragging them to a new destination. The only 
difference between a move and a copy is that for a copy you need to press the Ctrl-Select key 
sequence (see ‘The Mousekey) as you Select the original file. For example, to copy a file called 
Text _examp1le from the current displayed folder to the folder called files in the picture on the 


previous page, you would do the following: 


¢ Move the pointer over Text_example. 

¢ Press Ctrl-Select. Remember that since the Ctrl key is used as part of the Select 
sequence you need to press Ctrl-Fn-Backspace (using the backspace key for its 
optional Select function) in normal mode, and Ctrl-Backspace in Mouse Mode. 

¢ While holding Ctrl-Select, move the pointer over the files folder (dragging the 
icon with it). 


¢ Release Select and the file will be copied into the files folder. 


The Waste Basket 


With the File Manager is an associated wastebasket. This is a temporary storage area for files that 
are to be deleted. If you put a file into the wastebasket the icon will change to remind you that the 
wastebasket is not empty. If you open the icon you will see the files you have placed in there, and 


you may recover them if you need to. You can empty the wastebasket by moving the pointer into 
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the wastebasket window and pressing Menu. While holding down Menu move the pointer to the 


Empty Wastebasket option and release Menu. You will not be able to recover any files that you 


delete with the Empty Wastebasket option. 


File Manager Summary 


For further information on the DeskSet utilities please refer to the DeskSet Reference 


Guide. 


¢ OPENING A FILE 
To open a file you may Double-Select it, drag it onto an application or the workspace, 


or Select it and use the File menu to open it. Applications are started in the same way. 


* FOLDERS 
You can view the contents of a folder and move to that folder by Double-Selecting it, 


or by dragging and dropping it onto the workspace. 


¢ NEW FILES AND FOLDERS 
Make sure you are in the folder where you wish to create a file or folder. From the 
File menu Choose the Create Folder or Create Document options. A default file or 
folder will be created with the name NewDocument or NewFolder. This will be 


underlined and/or highlighted. 


* RENAMING FILES AND FOLDERS 
If a file or folder name is underlined you may immediately type in text to change its 
name (for example after it has just been created). Otherwise Select on the name area 
underneath the file or folder icon and then type the required text into the space, 


finishing with the Enter key. 


¢ MANIPULATING FILES 
You can move files by Selecting the desired file, and then dragging it to a new 
destination. For example, you may move a file from the current workspace to a folder 
by dropping it on the folder icon in the File Manager. You can also edit a file or print 


a file by dropping it onto the Text Editor or Print Tool icon if they are displayed. 


To copy files press the Ctrl key before performing the same drag and drop operation 
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as for a move. If the Ctrl key is pressed during the Select operation a copy will be 
performed rather than a move. Remember to use the Backspace key as Select for this 


operation. 


« CLIPBOARD 
The File Manager maintains a Clipboard area which you may use as temporary space 
to store files. The Cut/Copy/Paste keys on the keyboard or in the Edit menu 


automatically use the File Manager clipboard when invoked. 


¢« FILE CABINETS 
You can iconize the File Manager to create a filing cabinet of files. The icon will have 
the name of the directory in last use. You can reuse the File Manager at any time by 


Double-Selecting on the Filing Cabinet icon. 
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MAIL TOOL 


The Solaris Operating System provides powerful electronic mail facilities. The Mail Tool 


application allows you to send and receive electronic mail over the Ethernet or modem interfaces to 


other users. 


The Mail Tool icon shows a tray which is either empty (no mail), has closed envelopes in it (mail 


that has been read) or has new mail envelopes showing (new mail has arrived). 


You should not attempt to use the Mail Tool until you have set up your mail system, 


including the modem or network interfaces, whichever is being used. See the Mail 
Administration, Network and Modem installation sections of this guide for further 
information. You may also need to set up a mail server to receive mail for while you 
are disconnected from a network or phone line, and store it until you are connected 


again, see ‘POPtool’ on page 90. 
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To open the Mail Tool you need to Double-Select on its icon. The main Mail Tool window will 
appear providing all the facilities you need to organize your mail. If the icon is not present, you will 


need to start the Mail Tool by Choosing the Mail Tool option from the Workspace menu. 


Mail Tool ¥3 — /usr/spool/mail/usert 


view +) Edit ) Compose +) MailFiles FJ 


Next Delete | Reply 


Mon Apr 5 ° 


PLAS RA ABER TOTS IES 


Titems,Onew,Odeleted ! 


Mail System Connection 


The SPARCbook Operating System provides facilities to attach directly to a network with access to 
Internet based electronic mail facilities. The internal SPARCbook modem may also be used to dial 
in to a remote system to receive your mail. Further information on setting up the network and 
electronic mail can be found in the sections covering SLIPtool, POPtool and configuration of the 


Ethernet and Modem interfaces. 
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Reading Mail and Replying 


To view your mail you Double-Select the item that you wish to view from the list of items 


displayed by the Mail Tool. A second window will open automatically showing the selected mail 


If there is an attachment it will be shown in the bottom of the mail window. If you Double-Select on 
the attachment file icon the Text Editor will be opened if it is a text file, or Audio Tool will start if it 
is an audio file, allowing you to read or hear the attachment. You can save the attachment to a file by 


selecting the Copy Out option of the File menu in the attachment area. 


ae ae 


Mail Tool ¥3: View Message 1 


From users? Mon Apr 5 10:28:01 1993 med 
bate: Mon, S Apr 93 10:27: 404010 “| 
From: usersd (users) i 
To: uWseri@tecpube - 


Subject: Note of thanks 
Content-Trpe: x-sun-attachment 
Content-Length: 956 


Hello again DB, 


Just a note of thanks for your presentation last week, Everybody here found the 
discussion most i]luminating, We look forward to your next presentation in the 


I have attached some of the comments I have received for you to look at, 


Kind regards 


M 


Attachments 2 attachments (258 bytes) 


file ¥) edit ¥) 


Comments More_ Comments 
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You may reply to the mail by moving the pointer to the Reply button and pressing Select. A third 


window will appear with the title ‘Compose Message’. 


Mail Tool ¥3 - fust/spool/mail/usert 


Mail File: =!) 


From 1S cate 


‘Date: 
From: 


include ©) Deliver 5) Header ¥) clear) Voice.) 


Ta: userst 


Subject: 
Ce: . = = 
found 
prese 
I hay 
Attachments File ¥) Edit 7} 


To write your response, move the pointer to the start of the main area and press Select. The window 
will become selected and a cursor will be displayed at the start of the line. The main window is used 
to type the mail part of the message. If you want to include all or part of the sender’s message in 
your reply, you may select indentation or a bracketed format using the Include menu. Choose the 
desired menu option (Bracketed, which will place a header and a footer round the message, or 
Indented, which will use > symbols to show the original text). When you are finished, you can 


simply Select the Deliver button and the message will be forwarded for delivery. 


You can either use the Next button or Double-Select a new item for more mail. 
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Deleting, Printing and Saving Mail 


If you want to delete an item of mail it must first be Selected. Selected items have a rectangular 
border round the summary line in the main Mail Tool window. To delete an item first Select it, and 
then move the pointer to the Delete button and press Select again. The specified item will then be 
deleted. 


If you wish to print a mail message, it must first be Selected, as for the delete operation. To print a 
file Choose the Print option from the File menu. The mail message will now be printed on the 


default printer. 


Please refer to the system administration section for information on specifying the 


default printer. Note that the Mail Tool can only print to this printer. If you wish to save 
a mail file for printing out using the Print Tool you can do so by saving the mail to a+ 


file. 


2 Mail Tool ¥3: Mail Files 


Name: In-Bo, 


Save A Load ¥ ) create © 


ds 


CRY in-box We 
feel ples 

(a) Filemanager_1 
Oa) Filemanager_2 
CO) Filemanager_3 
Os) mailtool_1 

Os) mailtool_z 
Om) Mailtool_3 


Os) Text_example 


Incoming Mail can be saved into files called Mail Files which contain collections of mail messages. 
To create a Mail File, move the pointer to the start of the Mail Files text line in the top right hand 
corner of the Mail Tool main window. Type the name of the Mail File you want to create. Then 


Select one or more pieces of mail and move the pointer to the Move or Copy button. If you press 
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Select, the mail will be saved to the new Mail File. Using the menu options on the Move or Copy 
buttons you can save mail to different Mail Files. You can review Mail Files by simply Selecting 


the Mail File you want to view from the Mail File menu. 


To perform other operations on Mail Files such as emptying, renaming or deleting files, you can 
enter the Mail Files window by Selecting the Mail Files option in the File Menu of the main Mail 
Tool window. To perform an operation, Select the Mail File you want to use and then press the 


relevant button or menu option in the Mail File window 


Writing Mail 


To write and send mail, you should Select the Compose button. A new message window will be 
displayed. Type the name of the person who you wish to send mail to and then press the Enter key. 
You may then enter a subject which will form the header for the mail, and optionally another person 
to receive a copy. You can then type your message into the message area of the window and may 
attach a document by Choosing the Add option of the File menu in the Attachments area. A new 
small window will appear asking you to enter the directory and the filename of the file you wish to 


attach, 


Vf Mail Tool ¥3: Compose Message 


Include ©) Deliver ¥) (Header ©) Clear) | Voice.) 


To: wsersi@tecpubt 
Subject: shapshots 
ce: 


Here are the latest snapshots, I think you will agree, they are a 
definite improvement 


a 


Attachments = fije ©) Edit 7) 2 attachments (311383 bytes) 


a - 2 + 
- + 


Mailtool 2 Mailtoal_3 a 


Added 1 attachments for a total of 182k bytes 
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When you have specified the file you wish to attach, Select the End button. An icon will appear in 
the attached area showing the attached file(s). When you have completed your mail operations you 
may Select the Done button to quit the Mail Tool. The Mail Tool window will be iconized once 


more 


If you wish to add an audio file, you may do by Choosing the Add option or by Selecting the Voice 
button. This will start Audio Tool to allow you to record an audio message. This is described in 
more detail in‘ AUDIO TOOL’ on page 122. 


Automatic Mail Response 


When you are away from the office or on vacation, you may leave your SPARCbook switched on 
and attached to the network unattended to respond automatically to any mail it receives. To use this 
facility, Choose the Vacation Notifier from the Compose menu in the main Mail Tool window. If 
you Choose the Start menu option, a pop-up window will be displayed with a standard message. 
You can edit this message to your own requirements. The $SUBJECT field should normally be left 
since the system will automatically insert the title of the author’s mail in this field. An example of a 
modified message is shown. 


"Mail Tool ¥3: Vacation Setup 


Subject; I am on vacation 
Rvaaeadancas sink 
Precedence: junk 


Your mai] regarding "$SUBJECT" will be read 
when I return, 


If you have something urgent, please 
contact... 


Start) 


While you are away, all messages are stored as normal in your mail in box. Senders are notified that 


you are away if they send mail to you. 
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To stop the automatic mail responder on your return, Choose the Stop option from the Vacation 


Notifier menu. 


Mail Tool Summary 


For further information on the Deskset utilities please refer to the DeskSet Reference 


Guide. 


¢ READING MAIL 
To read your mail, Double-Select the Mail Tool icon if it is present, or Choose it from 
the workspace menu if it is not present. The mail window will then appear showing 
any incoming mail. To read a message, move the cursor to the relevant line and 


Double-Select. A new window will be displayed with the message. 


¢ REPLYING TO MAIL 
Select the Reply button and a Compose window will be displayed. You can type a 
response by Selecting the start of the main window and writing your message. When 
you have finished, Selecting the Deliver button will cause the mail to be forwarded 


and the Compose window to be closed. 


¢ DELETING MAIL 
In the mail window, Select the item of mail to delete and then Select the Delete 


button. 


¢ FORWARDING MAIL 
In the mail window, Select the item of mail to be forwarded and then from the 
Compose menu Choose the Forward option. A Compose window will be displayed 
with the message for forwarding. Select the To: field and type the name of the 


addressee. Then Select the Deliver button to forward the mail. 


* SENDING NEW MAIL 
In the mail window, Select the Compose button. After you have written the message 
it can be sent by Selecting the Deliver button. You may attach a file by Choosing the 


Add option from the File menu. 
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SAVING MAIL 

Mail can be saved in Mail Files. Select the Mail File using the Mail File menu on the 
top right hand corner of the Mail Tool window, or type the name of a mail file. Use 
Move and Copy to save selected Mail Messages to a Mail file. See also the Mail File 


window selected from the Mail File option of the Mail Tool file menu. 


VIEWING MAIL 
Choose the desired Mail File from the Mail File menu button options. This will 
become the default mail file. If you want to return to the Message In file, you simply 


Choose the Load In-Box option of the File menu on the main Mail Tool window. 


ON VACATION 
Choose the Vacation Notifier from the Compose menu in the main Mail Tool window, 
and Select the Start option. Edit your message and Select Start. On your return, Select 


the Stop option to stop automatic mail responses. 
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POPtool 


Using a SPARCbook to read and send electronic mail can pose problems when you frequently 
disconnect it from the network as mail sent to your SPARCbook will be returned to the sender if it 
is not available. If possible, you should arrange with your system administrator for your email to be 
sent to a permanent mail server from which it may be retrieved when you next connect your 
SPARCbook to the network. 


POPtool is provided to allow you to retrieve messages. from a permanent mail server attached to the 
office network using the Post Office Protocol (POP). This can be done whenever SPARCbook 2 is 
connected to the office network, either directly or via a dialup SLIP connection. For POPtool to 
operate correctly the mail server must have suitable POP server software installed on it. Details of 
this installation are given in the section ‘ELECTRONIC MAIL’ on page 180. 


POPtaal 


POPtool may be started by Double-Selecting the POPtool icon or, if the icon is not present, 
selecting the POPtool option from the Workspace Portable Menu. When POPtool is started the main 


POPtool window will appear. 


POPtool 


Massages in transit 


70000 


Props ) 
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To transfer mail from the POP server, select the ‘Props’ button. This will open a dialogue window 


which you should use to set the parameters necessary for mail retrieval. 


‘Mail Host: pophost, 


‘Username: userd 


Password: / 


Max message size: 50s |r| 


Retrieve every: 0 foe) Min 
Leave mail on server: 7 
Quiet: ©! No Debug: *!| No 


Apply} Reset } 


Mail Host is the name of the mail server. Username specifies the user for whom mail is being 
retrieved. The Password supplied should be your password on the mail server. If a retrieve interval 
is specified, POPtool will attempt to check the mail host periodically, otherwise mail will only be 


checked for when the ‘New Mail’ button is selected in the main POPtool window. 


When the server cannot be contacted, for example if your SPARCbook is not connected to the 
network, then messages will be produced to inform the user. These may be inhibited by setting the 


‘Quiet’ option. 


Mail that has been retrieved from a mail server with POPtool can then be opened and edited using 


the usual OpenWindows tools. 
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PRINT TOOL 


The Print Tool application is a simple interface to the printers attached to your own SPARCbook, or 
attached remotely to another machine on the Ethernet. Using the Print Tool you can print both 
PostScript and normal text files to suitable printers. The Print Tool will automatically queue files for 


printing to one or more printers and print them in the background. 


You should not attempt to use the Print Tool until you have set up your printer system. 


See ‘CONNECTING A PRINTER’ on page 146 for further information. 


The Print Tool icon shows a graphical representation of a printer with the name of the printer below 


it. If you need to start the Print Tool you should Choose it from the main Workspace menu options. 


printtool 


The simplest way of printing a file is simply to Select it, to drag it to the Print Tool icon (holding 
Select down) and then dropping the copy onto the Print Icon (by releasing Select). This will cause 


the file to be printed on the printer. 


To change the printer you want to send your file to, to stop the printing of a file, or to examine the 
status of the files that are queued for the printer, you will need to enter the Print Tool application by 


double selecting the Print Tool icon. The Print Tool window will then be displayed. 
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Print Tool ¥3 


Printer: 


laserjet—4rn 


Copies: 1 


Filter: | None Raster | Tex 


Plot | cifplot | troff 
pr control | other: 
Print) Status ) Stop Printing 
Rank Owner Files job Size 


Using the Print Tool you may specify a file to be printed, change the number of copies, or change 


the selected printer as shown below in the Print Tool summary. 


Printing Options 


By default the Print Tool will print ASCII files to the specified printer. In addition, you can specify 
a filter or a UNIX command line. To select a filter, you simply Select on the filter name in the Print 
Tool window. In the SPARCbook 2 bundled Operating System, only the pr filter is operational by 


default. The pr filter separates the file into pages and prints a header for each page. 


You may also specify a custom filter using available commands from the Solaris Operating System. 


For example, the a2ps command can be used for printing ASCII files to a PostScript printer. 


ly 


To try the following example, you must be using a PostScript printer. Please refer to 


“CONNECTING A PRINTER’ on page 146 for further information. 
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Open the Print Tool by Double-Selecting the icon or by choosing the Print Tool option from the 
Workspace programs menu. Move the pointer to the filters section over the Other button and press 
Select. A line will appear. For example, type a2ps on the line and then Select the Print button. The 
file will be printed using PostScript in the format you have specified, two pages per sheet in 


landscape format. 


Print Tool ¥3 


File: /usr/exportchome/juno/ds/Text_example 
Printer: lw 


Copies: 1 


Filter: None Raster | Tex 


Plot cifPlot | troff 
pr control | other: 
a2ps, 
Print Status Stop Printing 
Rank Owner Files Job Size 


ho entries 


The Solaris printing system is capable of dealing with a large number of different 
JOTE 8 S) I g x 

NOVE 
printers and print options. To describe them all is beyond the scope of this guide and 


you should refer “FURTHER READING’ on page 265 for further information. 


You should always ensure that the specified printer is connected before trying to print 
the file. For example, if you try and print to a printer on a remote system when not 


connected to the Ethernet network you will be given warning error messages. 
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Print Tool Summary 


For further information on the Deskset utilities please refer to the DeskSet Reference 


Guide. 


¢ PRINTING FILES 
To print a file, Select the required file from the file manager window or desktop. 
Holding Select down, drag the file icon on top of the printer icon and drop the file by 
releasing Select. Alternatively, enter the Print Tool by Double Selecting the Print Tool 
icon and specify the file name in the ‘File’ section at the top of the window. Then 


Select the Print button to print the file. 


* MULTIPLE COPIES 
In the Print Tool Window, either type the number of copies required or use Select 


with the mouse pointer over the up or down arrow to choose a number of copies. 


¢ PRINT STATUS 
Select the Status button to display the status of files to be printed. 


* STOP PRINTING 
If you want to stop the printing of a particular file, Select the file from the status part 
of the Print Tool window. Then move the mouse pointer to the Stop Printing button 
and press Menu. Choose the ‘Selected Print Job’ option and release Menu. 
Alternatively, you may Choose the ‘All Print Jobs’ option to stop the entire print 


queue. 
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CALENDAR MANAGER 


The Calendar Manager is an application which allows you to keep a diary and schedule. In a 
networked environment it also allows you to access and look up the calendars of other users on a 


network. The Calendar Manager icon shows the current date. 


To open the Calendar Manager, Double-Select on the Calendar Manager icon. If the icon is not 


present you will need to Choose the Calendar Manager from the Workspace Menu. 


By default, the Calendar Manager displays a month at a time. You can change this to a day, a week 
or a year at a time by Choosing from the View menu. For example, to view to a week at a time, 
move the pointer to the View button and press Menu. While holding Menu down, move the pointer 
to the Week selection and release Menu. The current week will be displayed on the main window. 
Depending on whether you are viewing by day, by week, or by month you can look at the next or 
previous period by Selecting the Next or Prev buttons on the top right hand corner of the window. 


Selecting Today will always bring you back to the current view. 
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Appointments and To Do Lists 


As well as the main window, you can pop-up separate windows at any time to display lists of 
Appointments and To do items for a particular day, week, month or year. First, Select the day, week 
or year you want the lists for (by default it will be the current period) and then, to pin up the To Do 


list for the selected period, Choose the To Do option from the second level menu behind the View 
button. 


Calendar Manager ¥3: user1@tecpub2 


_wleW ¥) Edit) Browse ¥) Print ©) Prey) Today) Next ) 
Week Starting Mon, April 5 1993 


Thu 8 


3:00am-10:00a |3:00am-12:30p | 7:15am 3:00am $:00am-4:00pm 
Weekly briefing Book review mee | Catch Brussels fli | Catch homeward | Meet with well dr 
7:45pm-10:00p 10:00am-4:30p |2:00pm-3:00pm 
Morwich Yo Man U Give sales presen | Give briefing 

6:30pm-11:00p 
Reception 


Sunil 
AT T Ww T F S S 


oon 


al sbi 
No 


NO OS oh 
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To enter an appointment or To Do item, you Select the day you want to schedule it for and then 


Choose the Appointment option in the Edit menu. Then follow the steps below: 


} 


Date: - 


Appointments 


9:00 Weekly briefing 
745 Norwich ¥ Man Utd 


Repeat: ©) None 


_lWisert ) | Delete ) Change j | clear ) Restore Size ) 


* Select the Appointment or To Do button as appropriate 

¢ Type information describing the appointment in the What field. 

¢ Move the pointer to the Start menu button and Select a Time. Each hour has a 
submenu with 0, 15, 30 and 45 minute options. By default the time in the End field 
will be set to one hour later. To change the End time use the End menu button. 

¢ Ifthe appointment or meeting is a regular one you can use the Repeat button menu to 
choose the time between meetings (for example daily or weekly). 

¢ If you want to be reminded of the appointment Select the beep and/or flash buttons. 

¢ Normally, others on the network with have access permission granted will be able to 
see your appointments. If you want to keep this appointment private you can Select 
the ‘Your Eyes Only’ button. 

¢ When you have entered all the information you need Select the Insert button and the 


appointment will be entered into the Calendar Manager. 
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If you want to enter further appointments for another day Double-Select on the new day in the main 
Calendar Manager window. To Delete an appointment you need to Select a date and display the 
appointment window using the Edit menu. Then Select the appointment in the list you want to 
delete and Select the Delete button. To Do items may be deleted in the same way. To change an 


appointment or To Do item Select the Change button rather than the Delete button. 


Browsing Remote Calendars 


Using the Calendar Manager, you can look at other peoples’ calendars if you are allowed access. It 
is possible to schedule meetings and to send mail to each attendee about them. To look at other 
calendars you need to Choose the Multi-Browse option from the Browse menu. Using the Multi- 
Browse display, you can see when time slots are free. You can also Select a time from the main 
Calendar Manager window and see in the Multi-Browse display who is busy at that time. In the 
example below, three calendars are displayed, and the check mark shows that users1@tecpub1 


is busy at the time selected. 


Schedule.)  Mailw) Goto; F)AEMSS 


= Calendars Busy At Time Selected 


user @tecpube ee = 
users1@tecpubd a 


Hs SSNs et Seat ss Reeatelssehaseslstontseian a recente conned |e 


Calendar: 7 jUsersi@tecpubt 


April 1993 


NOC Swh 


2 Calendars Displayed 
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In order to add calendars to the Browse menu, you need to be in the Multi-Browse window. Type 
the account name of the user you wish to see. If the user is not a local user (not one on your own 


machine) you also need the *@’ symbol, followed by the user’s machine name. For example: 


userl would be the user with the account name user1 on your own 


machine 


ben@tecpub2 would be the user with account name ben on the machine called 


tecpub2. 


Using the menu you can add, delete, or sort the calendars that you access. 


Scheduling Meetings 


Once you have found a suitable appointment time, you can schedule the appointment into the 
calendars of all the users who have given you Insert Access. Double-Select on the starting time you 
would like to schedule the meeting for in the Multi-Browser menu. The Appointment editor 


window will then appear. 


CM Browser editor 


Dae Ls dea | 


Month / Dey 


10:00 Give sales presentat 
Start: 7 | Too 


End: 


Calendars Insert Acces 


_Pelete ) : 
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Follow the steps below to schedule the meeting: 


¢ The Selected time will be filled in, although you can change the meeting start or end 
by Selecting the Start and End buttons. 

¢ Fill in the meeting details in the What: text field. 

* Press Select on the Insert button to add the appointment to all the Selected calendars 


(those to whom you have granted Insert Access permission). 


You can send mail to the meeting attendees using the mail facilities in the Calendar Manager. This 
can also be used to mail those users for whom you do not have Insert Access permission so that they 


can schedule the appointment themselves. 


To send mail to all the users whose calendars you have selected, you should Select the Mail... 
button in the Multi-Browse window. The meeting subject and times will already be filled in. You 
may modify the message or add to it before sending if you so wish. When you are ready to send the 


mail, Select the Deliver button. 


Customizing the Calendar Manager 


You can customize the Calendar Manager to your own requirements by Choosing the Properties 
option from the Edit menu in the main Calendar Manager window. In order to see all the options, 
you may use the Menu button at the top of the window. The Access List and Permissions option 
allows you to specify who can Browse your own Calendar, who can insert and who can delete 


appointments. 


The default is that the World (i.e. all users) can browse your calendar but not modify it. 


IN OT > Remember that even when others can browse your calendar they will not be able to see 
i NG l= » 

f aes 

is 


items that you marked with the Your Eyes Only setting. 


You may add or delete users from the list using the same procedure as when adding remote users to 


the browsing facility (see above). 
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Printing Calendars 


Using the Calendar Manager you can print day, week, month or year view calendars, as well as 
Appointment and To Do lists onto a local or remote PostScript printer. If you are not using the 


default printer you can Select a different printer using the Printer Settings option in the Properties 


menu. This is accessed from the Edit menu in the main calendar window. 


You should not attempt to use the Printer until you have set up your printer system. See 


‘CONNECTING A PRINTER’ on page 146 for further details and information. 


_View ¥) Edit ©) Browse ©) Print © ) . day 


March 1993 
So a Bas 
Sart aes ds Shep rcieey ES 
oe ar eo aes 
41a Tec te Te to 20 
el 22 24) 2425 26.2" ga | 9:00 -12:30 Book review meeting 
629.5073 | 
April 1993 Tee 
Soe oh a Poe ta 
jeaeer ann 


Te TS 2022 27s 
25 262202825030 


May 1993 


3:00 - 4:00 Phone conference 


eed ere Ges" eae) Be are 3p 
1 

2) SuLe a Bion e 4p 

SO ae tea aalS 

IG Ve Ve Veen aise2 Sp 

Ne aa Pia SA MPAC adm ee 

30031 6p 


To print calendar views, Select the day which you wish to print. Then move the pointer to the Print 
button and Select the day, week, month or year button for the period for which you want a print out. 


Finally, you can print the appropriate appointment and To Do lists from the Print menu submenu if 


you wish. 
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Calendar Manager Summary 


For further information on the DeskSet utilities, please refer to the DeskSet Reference 


Guide. 


* ICON 
The Calendar Manager Icon shows the current date. If you want to use the Calendar 
Manager, Double-Select on the Icon. If there is no Calendar Manager running, you 
can start it up by Choosing the Calendar Manager option from the main Workspace 


menu. 


¢ VIEWING 
View by day, week, month or year by Choosing an option from the View menu. 
Change the day you period you are looking at by Double-Selecting on the period. 
Look at Appointments or To Do lists by Choosing from the second level menus 
behind the View button. 


¢ MAKING APPOINTMENTS 
Use Select to choose the day you require to make an appointment. That day will then 
be highlighted. Choose the Appointment or To Do options from the Edit menu. Type 
in and Select the information, time, alarm and Your Eyes Only as required. Select the 


Insert button to make the appointment. 


* CHANGING/DELETING APPOINTMENTS 
Select a date and Choose the Appointment or To Do option from the Edit menu. 


Select over the item(s) you want to delete and Select the Delete or Change button. 


¢ USING OTHER CALENDARS 
To Browse other peoples calendars, Choose the Multi-Browse option from the 
Browse menu. Select the calendars you wish to view. To make an appointment, 
Double-Select on a time in the Multi-Browser menu. Enter the appointment details 


and Select the Insert button. To close a Selected calendar, Select it again. 


¢ PRINTING 
Choose a day, week, month or year view to print from the Print menu. Move to the 


Second level menu to print an Appointment or To Do list. 
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TEXT EDITOR 


The Text Editor is a simple editor application for text documents. It does not have the capabilities of 
a word processor. To access the text editor, you can either drag and drop an existing text file onto 


the workspace from the File Manager window or Double-Select the Text Tool icon. 


You can explicitly open the editor for a new edit from the Workspace Programs menu. The base 


Text Editor window will then be displayed. 


- ‘Text Editor ¥3 - Textfile_Name, dir; /usr/export/home/juno/ds 


File view Edit Find 


Text Tool provides basic text editing Facilities, : 


SSS 


The header displays the name of the file you are editing (or “NONE” if you have not yet assigned a 
name to the file) and shows you the directory where it is located. When you have made changes, the 


word ‘edited’ is displayed following the file name. 
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Manipulating Text 


To create text, Select the window by placing the pointer in the main window area and pressing 
Select. Then type the desired text into the window. The Del or Backspace keys will erase text and 


you can use the cursor keys or the Mousekey pointer to move the text insertion point. 


You can select an area of text using Select and Adjust as follows: 


* Move the pointer and press Select to set the insert point. 

¢ Select a word by moving the pointer over a word and Double-Selecting. 

¢ Select a line by moving the pointer to the line and Triple-Selecting 

¢ Select the entire document by Quadruple-Selecting. 

¢ Select an area of text by moving the pointer to the start of the desired region and 
pressing Select. While holding Select down, move the pointer to the end of the area 
and release Select. Alternatively, use Select and Adjust. 

¢ Selected text may be deleted (by pressing the Del key), replaced (by just typing the 
replacement text), cut or copied (by using the Cut or Copy keys). Text may be pasted 


to a different place or a different window using the Paste key. 


Text Files 


The File menu allows you to load and save your text files. To load a file, you can Select the Load 
File option in the File menu. A popup window will ask you to specify the directory and the file 
name. By default the selected directory will be your home directory where your own files normally 


live. Similarly, you can save the current file or include another file from the File menu options. 


Note that the Text Editor stores text as you write it. If you write a long line of text without Carriage 
Returns, the text will be wrapped to display separate lines. However, the text is stored as a single 
line. You can format a document into lines of no longer than 72 characters from the Extras menu. To 
access the Extras menu, move the pointer into the main Text Editor window and press Menu. While 
pressing Menu, move the pointer to the Extras option and then to the Format option. This will 


reformat the text into lines of no more than 72 characters so that it is suitable for printing. 
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Text Editor Summary 


For further information on the DeskSet utilities please refer to the DeskSet Reference 


Guide. 


OPENING A FILE 

You can open a file by selecting it from the File Manager window and dragging it 
onto the workspace. Alternatively, you can start the Text Editor from the workspace 
menu and can specify a file to load from the File menu of the main Text Editor 
window. To do this move the pointer to the workspace area and press Menu. While 
holding Menu down, Choose the Text Editor option from the Programs menu. When 
in the Text Editor, move the pointer to the File button and Choose the Load File 
option using Menu. Specify the directory and file name in the pop-up window and 


Select the Load File button. The requested file will be loaded into the Text Editor. 


SAVING FILES 
To save a file, move the pointer to the File button and Choose the Save File Option 
using Menu. Enter the desired file name into the Save File pop-up menu and Select 


the Save file button. 


PRINTING FILES 

Depending on how you have entered text, you may want to format the text into lines 
before printing. See the main section above for details. To print a file, you can either 
save it and print it from the File Manager or you can simply Drag and Drop it onto 
the Print Tool application. To do this, move the pointer to the Text symbol on the top 
right hand side of the Text Editor window and press Select. While holding Select 
down, move the pointer, dragging the text symbol until it is over the Print Tool. 


Release Select and the file will be printed. 
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FAXtool 


The FA Xtool is provided to allow you to send and receive faxes using the internal modem or an 
external modem connected to the serial port. This tool allows you to specify an ASCII or a 
PostScript file and to send it by fax to a specified destination. It also provides the facilities to send 


more than one file (for example, a PostScript header page and ASCII text) as a single Fax. 


FAXtool utility uses the internal modem interface. Before using the FAXtool facility 


you must connect the modem interface to the telephone line. Refer to the chapter 
“USING THE INTERNAL MODEM’ for more information on setting up the modem 


interface. 


If the FAXtool icon is not on your workspace, you can start up the application by Choosing the 

FA Xtool from the Workspace Programs menu. To send a Fax you can drag and drop a text file onto 
the FAXtool icon and the FAXtool window will appear with the dropped file in the queue. You can 
start FAXtool by Double-Selecting on the FAXtool icon, 


Test Inc. 


:-- --'-- 02 Queued | a 


lsinabiaeailiinicsitses eis Eipeercn | 
Shutdown I 
| 


The main FAXTool window contains a list of fax messages and denotes whether they are queued to 


be sent, or have been sent or have been received. It also provides status and error information 
during fax transactions. 
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Sending a Fax 


To send a fax with the main FAXtool window open, Select the Transmit button, and the Send Fax 


window will open. 
—hl Faxtool Send Fax 


transmit preview ) add) delete | 


1233456789 Test Ine. 


OUIgIGe LINE GG es 
Main Number: 1223456789 _ 
Place Name: Test Inc. 
File Name: faxtool.h faxtool.h 
Fite: Aue 


Fax Header: 


The Send Fax window shows a list of the currently available fax numbers. When you first start up 
the FAXtool, this box will be blank. 


To send a fax follow the procedure outlined below: 


¢ Select a fax number from the fax numbers available, or Select the Fax Number field 
and enter the required Fax number. 

* Type the file name to send into the File Name field. You may specify multiple file 
names on the line, separated by space characters. 

¢ If you want to include a separate header, page type the name of the file containing the 
header you want to use. If you do not want to include a header file, this field should 
be blank (see the note below). 


¢ Select the Send menu. The Send menu contains the following options: 


There is also a status line that give progress reports during fax preparation and transmission. 
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Alog of all fax transmissions (and attempts) is maintained in /var/adm/fax.1log. 
Default setups (filter, header filename, dialing method etc.) are stored in 


/var/adm/faxtool. 


It is a legal requirement in the United States of America for a fax message to identify 


the sender, either on a header page on the message pages. Please refer to the FCC 


notice on Page iii. 


If the fax is only partly transmitted, or if the remote number is busy, FAXtool will retry for a preset 


number of attempts and then, if still unsuccessful abort the operation. 


Creating a Fax directory 


To add a fax number to the directory, fill in the text fields with the number and name (the Main 
Number field). The name is used to label the number for your convenience (for example, Home, 
Office or Mall). Select the Add button once you are satisfied with the details of the number you 


have entered. 
To delete an entry, Select it from the Fax Number pane and then Select the Delete button. 


The Fax number is in two parts. The first, the Outside Line field, is used to enter the number 
required by your exchange to access an outside line. It may be left blank if you are connected 
directly to a public telephone line. The Outside Line number may be followed by one of these 


special characters: 


= Wait for a secondary dial tone before proceeding 


- Delay for 4 seconds before proceeding 


The Outside Line number will be retained after you quit FAXtool and may be used again on the 


next session if or may be changed. 


The second field is used to enter the Main Number. This number may be selected from the directory, 


or may entered from the keyboard and added to the directory as described above. 
Both numbers may include the following special characters: 


p Specifies use pulse dialing 


t Specifies use tone dialing 
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The dialing mode may be selected from the Send menu, as described below, but these characters 


may be used if you need to change dialing mode part way through a number. 


Configuring FAXtool 


You may set up FAXtool to meet your particular requirements using the Configure option in the 


main FAXtool window. 


Fine | 


Poll Time: Fast | Normal. Slow | 


Receive Fax 
Spooler: 
Modem: | Internal External | 
Outside: 
Main: 
Blind Dial: | No 
Retrias: 


Retry Time: 


Apply ) Reset | Reset To Factory | 


This window allows you to set up the characteristics of FAXtool. 


Resolution This allows you to select between 2145 lines per page (fine), or 
1072 lines per page (normal) resolutions. A fine resolution fax will 
show more detail when printed by the remote fax machine, but a 
normal resolution fax provides will take less time to transmit, 


costing less in phone charges. 


Poll Time This controls how often FAXtool consults the server for incoming 


fax messages and status information. 


Receive Fax This control allows you to turn the FAXtool receiver on or off. This 


is of use when you are using the internal modem for another 


110 


Spooler 


Modem 


Outside 


Main 


Blind Dial 


Retries 


Retry Time 


FAXtool 


purpose and do not want that interrupted by incoming faxes, or if 


you simply want privacy. 


The spooler is a background activity that collects and dispatches 
incoming and outgoing faxes. With the spooler turned off, fax 
messages can be written, saved and stored but will not be 
dispatched from the SPARCbook 2. Fax messages cannot be 


received while the spooler is off. 


This option allows you to select between the SPARCbook 2’s 
internal fax modem and an external fax modem connected to the 


serial port. 


This option allows you to select between pulse or tone dialing for 
dialing on a private telephone system. You would use this option to 
gain access to an outside line when your private exchange uses 


different dialing from the public telephone system. 


This allows you to select between tone and pulse dialing on a 


public telephone system. 


This controls whether FAXtool waits for a dialing tone between 
dialing for an outside line and dialing the main number. With blind 
dialing selected (Yes), SPARCbook 2 does not wait but continues to 


dial without pause. 


This selects the number of times FAXtool will attempt to transmit a 


fax before it considers it a failure. 


This controls the time interval between retries. 


PostScript and ASCII Files 


The FAXtool operates on PostScript format files. PostScript is a graphics description language 


developed by Adobe Systems. The FAXtool automatically detects whether the files you have 


specified are PostScript files, or normal ASCII text files. 
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If the specified file is a PostScript file it is scaled to 8.5” by 11” on a page by page basis and 

\ 
transmitted. If the specified file is a normal ASCII text file it is automatically converted to 
PostScript prior to being sent. This operation is carried out by a filter. By default the filter (a2ps) 


converts the text into 66 line pages and adds a border at the top with the file name. 


You can change to any filter made up of commands available in the operating system. Once you 
have selected a filter it will remain the default until you change it again. To change the filter, move 
the pointer to the Filter: field and press Select. Type in the filter you want to use. When you next 


send a fax, the new filter will automatically take effect. Two examples of filters are shown below: 


pr -l 66 | a2ps -h Format pages into 66 lines per page with a text header 


and footer. Do not print the a2ps header 


faxp [-1l] Format the file into pages printed with the title “FAX 
from user” and with the date (user will be your account 
name). If you specify -l the pages will be printed in 


landscape mode, two to a page. 


Header Page 


You can also specify a header file for the first page of any fax you send. The default is no header 
page. To specify a file Select the Header text field and type the name of the header file to use. By 
default no file is specified. The header file can be PostScript or normal ASCII. The header file will 
be used on all faxes until you change the header file again. If you leave the Header text field blank 


no header page will be sent. 


Previewing Faxes 


If you Select the Preview button, instead of the Send button, FAXtool will display the fax on the 
SPARCbook 2 screen. (This may also be used as a simple viewer for PostScript files, but is not as 
sophisticated as the pageview utility), You can use the Next button to step through the pages. If you 
unpin the popup window the previewer will exit. If you then wish to send the fax, you can Select 


the Send button in the main FAXtool window. 


HAZ 


FAXtool 


Receiving Faxes 


To receive fax messages, you must have your SPARCbook 2 connected to the telephone line, and 
have the Receive Fax option anabled and Spooler option active in the FAXtool Configuration 
window. The SPARCbook 2 is able to detect a fax message from information contained in the data 
file header. Incoming faxes are stored by the SPARCbook 2 but other data is discarded. Whenever 
you start FA Xtool it refers to the spooler to find if any new fax messages have been received since 


it was last active. 


Printing Faxes 


To print a fax message Select the message in the main FAXtool window and then Select the Print 


button. You will need to print it to a Postscript printer. 


FAXtool Summary 


¢ SENDING A FAX 
Drag and Drop a file from the File Manager onto the Fax Icon. Alternatively, if no 
icon is displayed Choose the FAXtool from the workspace programs menu and type 
the fax number and file name into the relevant text fields. Select a fax number from 


the directory and then Select the Send button. 


¢ FAX DIRECTORY 
Open the FAXtool and Select the Fax Number field. Type in the name (starting with 
lower or upper case A-Z) and then the fax number. Select the Add button to add the 
entry. To delete a number first Select it in the directory part of the window and then 


Select the Delete button. 


¢ FILTER 
You may specify a command line to preprocess text files for the FAXtool. This filter 


output must be PostScript. See the examples above for further information. 


* PREVIEW 
You can preview a fax one page at a time. Select the Preview button in the main 
FAXtool window. 
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COMMAND TOOL 


The Command Tool provides a terminal interface into the Solaris Operating System. You may have 
multiple Command Tools running at any one time. Using the Command Tool you can directly 
access all the Solaris Operating System commands and facilities directly. These facilities are 
required to perform some of the system administration procedures described later in this Guide. A 
summary of the UNIX commands available in the bundled Solaris Operating System is provided at 
the rear of this manual. Solaris provides a choice of command line interpreters or UNIX ‘shells’. 
The Command Tool will open a new shell of the same type that account starts when you login (by 


default the ‘C’ shell, csh). 


By default the erase character is set to the DEL key. The interrupt character to stop a 


process is the Ctrl-C key sequence. The backspace key sends a Ctrl-H sequence to the 
Command Tool which will not erase a character. If you make a mistake typing a 


command line use the DEL key to erase it, unless you have changed the default erase 


cmdtool - /bin/csh 


ani Mailtool_4 Printtaol_2 
an_2 Mailtool_2 Printtool_3 
3 Mailtool_3 f 
Mailtool_4 
Mailtool_s 


POPtool_3 
Printtool_4 


For further information on UNIX Shells, the command line interface, and the available 


UNIX utilities you should refer to UNIX manuals or textbooks, see ‘FURTHER 
READING?’ on page 265. 
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You can see a ‘history’ of previous output by using the sliders on the edge of the Command Tool 
window. For information on customizing the Command Tool window, see the chapter 
‘CONFIGURING YOUR DESKSET ENVIRONMENT’. 


CLOCK, CALCULATOR AND OTHER TOOLS 


Several other tools are bundled with the SPARCbook 2 implementation of Solaris. In particular, the 
general purpose Clock and Calculator are available from the Workspace menu and provide basic 
clock and calculator functions. Both applications have additional facilities which are summarized 


below. 


For further information on the DeskSet utilities, please refer to the DeskSet Reference 


Guide. 


Clock Summary 


¢ DISPLAY CLOCK 
The Clock can be displayed as an icon or as a window. To start the clock, Choose the 
clock from the Workspace menu by moving the pointer to an unused part of the 
workspace and pressing Menu. Choose the clock option and the clock menu will be 
displayed. To display it as an icon, Select the icon button on the top left hand corner. 


You may also resize the clock window using the Resize corners. 


¢ CUSTOMIZING 
You can customize the clock by Choosing the Clock properties window. Move the 
pointer into the main Clock and press Menu. Select the properties option and a popup 


window will appear. 


« ALARM CLOCK 
From the Properties window you can set a stopwatch (watch the clock as you reset, 
start and stop the stopwatch), or set an alarm time. The system will beep at the 


specified time unless you specify a command to be carried out instead. 
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Calculator Summary 


¢ STARTING UP 
You can start up the calculator from the Workspace menu by Choosing the Calculator 
option from the main Workspace menu. This can be iconized by Selecting the Icon 


button on the top left hand corner of the window. 


* MENUS 
Buttons with the triangular menu symbol have menus of options accessed in the 


normal way by moving the pointer over them and pressing Menu. 


¢ MEMORIES 
The calculator has 10 memory registers accessible with the Mem...,Rcl, Sto and Exch 


buttons. 


* FUNCTIONS 
Using the Fun button, you can define your own functions. If you Select the Fun 
button a popup window appears. You can define up to 10 functions numbered 0-9. 
Enter a name into the Description field and the function in the Value field. When you 
Select the Enter Function button the function will be stored and will then appear in 


the Fun menu whenever you use the calculator. 
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SLIPtool 


SLIPtool is provided by SPARCbook 2 to allow you to communicate with remote computers using 
a modem or direct serial connection. This is a particularly valuable facility in a portable computer 
as it allows you to communicate with other machines when you are out of the office and cannot 
connect directly to the office network. Once a SLIP connection has been established all of the 
regular network applications may be used. For example, using POPtool you may rlogin toa 


remote machine, remote copy a file or retrieve mail. 


For SLIP services to be used a suitable dialup server must be attached to the office 


network and installed with the Tadpole SLIP Utilities. This is discussed in “REMOTE 
NETWORK ACCESS’ on page 209. 


“SLIPtool 


SLIPtool has two icons. The first one shows that it is inactive, and the second shows that data is 
being transmitted or received via the SLIP connection. If the SLIPtool icon is not on your 
workspace, you can start it from the Workspace Portable menu. A window will appear from which 
you may Choose to connect to a remote system, disconnect from a remote system or obtain status 


information. 
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Connecting to a Remote System 


To connect to a remote system, move the pointer over the Connect button in the SLIPtool window 


and press Select. A dialogue window will appear as shown below. 


"SLIP Connection 


mercury 
Venus 
jearth 
jupiter 
SPARCbook: jupiter, 
Target: earth 
Phone: 324-4444 
Pulse Dial 
Dataport 
SLIP configuration 


Compress 
af ICMP 
private 


auto 


Cannect ) Save } 


The scrolling list at the top of the dialogue window contains the names of all systems that may be 
contacted. When a system is first selected, SLIPtool will provide default values for the remaining 


fields in the dialogue box. These may be modified and will be saved when the connection is made. 


A number of options may be used to control the behavior of a SLIP interface and the type of 


communication that may take place through it. The options and their actions are as follows: 
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Pulse Dial When enabled, SPARCbook 2 uses pulse dialing to dial up the 
target. If this option is left unchecked tone dialing is used. The 
dialing mode may also be affected by the t and p special characters 


embedded in the phone number. 


Dataport When enabled, SPARCbook 2 may be used with a dataport. It 
allows you to dial by hand and then Select OK when you are 


connected. 


compress When enabled, header compression is performed on all packets 
transmitted from the interface. Packets received on the interface 
should also be compressed. This leads to significant increases in 
throughput but may only be used in conjunction with a remote 


interface that is also using header compression. 


ICMP When enabled, ICMP packets may be transmitted through the 
interface. By disabling these packets, certain network commands, 
such as ping, will not operate through the interface and the 


bandwidth of the SLIP connection will be protected. 


private When enabled, the interface will be marked as PRIVATE and will 
not be made known to other networks. Packets from other hosts 


will not be routed across the SLIP connection. 


auto When enabled, the interface will automatically use header 
compression if a compressed packet is received. If no compressed 
packets are received then no compressed packets will be 


transmitted. 


When the Connect button is Selected in the dialog window, your SPARCbook will attempt to 
establish a connection to the remote machine. If the device cannot be opened or already has a SLIP 
interface attached to it, then an error message will be displayed. This command will also fail if the 


SLIP module has not been loaded or if all of the available SLIP interfaces are busy. 


Once the connection is established you may communicate with the remote host using any of the 
regular network utilities. If the network routing daemon is running on SPARCbook 2 and the dialup 


host, then any machine on the remote network may also be accessed, see ‘Configuring For a 
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Network Without NIS’ on page 193. For example, using the connection shown in the dialogue box 
the following command may be used to retrieve a file from the remote dialup host. Note that the 


regular network name for the remote host is used. 


% rep earth:/tmp/datafile /tmp 


Once a serial interface is being used as part of a SLIP connection, that interface may no longer be 
used for normal character input or output. This means that if the modem is being used to provide a 
SLIP connection, it may not be used to dial another host or to send a fax until SLIP has been 


disconnected. 


Disconnecting a SLIP Connection 


You may disconnect SLIP by Selecting the Disconnect button in the main SLIPtool window. You 
should always ensure that the SLIP connection is inactive before disconnecting the modem or serial 


interface cables. 
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TZtool 


Many applications require time-of-day information to function properly. This can be inconvenient 
when using a computer on the move as you would normally need to edit some system files to 
change the time-of-day information each time you pass between time zones. SPARCbook 2 
provides an OpenWindows utility called TZtool (Time Zone Tool) to make changing the time-of- 


day in your system as easy as possible. 


TZtool allows you to set the clock for a large range of locations in the world or relative to 
Greenwich Meantime (GMT). TZtool can be started be Choosing Change Time... from the Portable 


menu. 


tztool 


Selected Timezone: GB-Eire 


Timezone 7) Apply) _Exit 


You can Choose a time zone from the Timezone menu. For example to change to the US Central 
District Time, move the pointer to the Timezone button and press Menu. While holding Menu 
down, move the pointer to US and through the arrow to reveal further choices. Move the pointer to 
“Central” and then release Menu. The TZ Tool window will display the currently selected timezone 


as “US/Central”. To complete the change Select Apply and then Exit. 
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AUDIO TOOL 


SPARCbook 2 provides sound recording and playback facilities. Audio Tool allows you to record, 
play and edit sounds, and to control the SPARCbook 2’s audio interface. Audio Tool is started by 
Double-Selecting the Audio Tool icon or, if the icon is not present on the workspace, by Choosing 


Audio Tool from the Workspace menu. 


Wwelcormeau 


Before you can record speech or playback sounds you need to connect an external microphone and 
headphones or speakers with in-built amplifiers. These can be connected to audio interface on the 


rear of the system via the audio interface breakout adapter supplied with your SPARCbook 2. 


os = GS 


= Wooo fin cy) IOI 


Audio 


Interface 


INOTE . You may only use external speakers with SPARCbook 2 if they are powered externally. 
F , “Active” speakers of the type available for personal stereo systems are suitable. An 
audio accessory kit is available from your SPARCbook supplier contains the correct 
speakers and a microphone, see ‘STANDARD CABLES AND ACCESSORIES’ on 


page 254. 
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The picture below shows the main Audio Tool window. 


AudioTool ¥3- welcomeau 


volume ©) painter: 0:12.4 


0:00 i? 705 fa 210 


Length: 002.4 


The Audio Tool window contains all the normal controls found on a tape recorder and a Display 
Canvas in which the audio data is displayed in graphic form. A position pointer indicates the current 
stage reached in the sound being played and may be moved by using Select to drag it along. You 
may select portions of the sound using the Select and Adjust keys and edit the sound using the Cut, 


Paste and Copy keys, as you would text when using the Text Editor 


Playing Sounds 


To play a sound, you should first load a valid audio file by Choosing the Load option from the File 


menu in the main Audio Tool window. 


Audiotoo! AudioTool: Load File 


File Edit Volume % Directory: /demos/sounds 


laugh.ay 
laughter.au 


I phone_sounds 
rooster.au 
sample.au 
Spacernusic.au 
splat.au 
trainaw 
welcome.au 


whistle.au 


Name: welcameau, 


load 
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When the file has been loaded, Select the Play button. You may need to adjust the volume by 


Choosing the Play option from the Volume menu. 


AudioTool: Play Yolume 


Play Yolume: 50 
Monitor Volume: 0 


Pause Play} 


Spki | Jack 


Since the SPARCbook 2 system does not provide an internal speaker, you should only 
play sounds through external headphones or speakers. Do not Select the Spkr option 


from the Play Volume window. 


The Play Volume slider controls the sound output level from the external speakers or headphones. 
The Monitor Volume slider controls the volume of the audio input signal channelled through the 
output. This is useful when an audio source, such as a CD player, is connected to the microphone 
jack on the adapter cable. By adjusting the monitor volume you can listen to the audio input without 


necessarily needing to record it. 


Sound Recording 


To record speech, or other sounds, you should Select the record button and then speak into the 
microphone. Place the microphone one or two inches from your face as you speak. You may find 
that you need to adjust the sensitivity of the audio circuits to a suitable level for the sound source in 
use. To do this, Choose Record from the Volume menu in the Audio Tool main window and the 
Record Volume control window will be displayed. 

- AudioTool:Record ¥olume = 


seinen mnncenetnnncnnn 
Lod vhs Sh ——— 


ame 
Continue speaking normally 
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You can adjust the record volume by entering a value of between 0 and 99 in the text field, by 
moving the slider or, alternatively, you can Select the Auto-adjust Record Volume button. The Auto- 
adjust Record Volume feature sets the recording level automatically by scanning the input sound 
data to determine its loudness. The recording level is set to maximum and then adjusted down until 
the optimum level is achieved. Prompts are issued to advise you to raise or lower your voice, or to 
adjust the volume control of the input device. Data recorded during the Auto Volume Adjust 
operation is discarded. An input level meter is displayed while sampling takes place showing the 


peaks and lows in the sound input. 


Having recorded speech, or other sounds, you can save the new audio data using the Save As option 
from the File menu as a compressed or uncompressed file. A compressed file offers the advantage 


of consuming only half the space, while the uncompressed file will load faster when opened again. 


MATE Audio files can be very large. For example, a 10 second audio file occuppies almost 
INOUE 

F 80Kbytes of disk space when uncompressed. Use the Compressed option if disk space 
is of prime consideration, and use the Uncompressed option if loading time is more 


important. 


You can include previously recorded sound files along with the new sounds by Choosing the 


Include option from the File menu in Audio Tool main window. 


Audio Mail Attachment 


Mail Tool allows you attach an audio file to a mail message. To do this, you need to have an active 
Compose window open in Mail Tool. Select the Voice button from the Mail Tool Compose window 
and Audio Tool will start automatically, allowing you to record your message. You can include 
previously recorded sounds along with speech by Choosing the Include option from the Audio Tool 
File menu. When you have completed your audio message, Choose Save from the File menu in the 
Audio Tool window and the newly recorded message will appear in the Mail Tool Attachments 
pane. If required, you can play and edit an audio file from the Attachments pane by Double- 


Selecting the audio file’s icon. 
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An audio file will play automatically on selection only tf this facility is selected in the 


Audio Tool properties window, as described next. 


For further information about composing mail messages, please refer to ‘MAIL TOOL’ 


on page 81. 


Audio Tool Properties 


You can modify the way Audio Tool operates to suit your own particular requirements by Choosing 


the Properties option from the Edit menu. This provides Auto Play-on-Load and Selection options, 


which set Audio Tool to play sound files automatically when loaded or Selected. Silence options 


cause Audio Tool to detect silence, and allow you to adjust the silence threshold for the audio 


circuits. The Properties window also allows you to select a temporary file directory in which sound 


files are placed until saved. 


Audio Tool Summary 


INGKE 


For further information on the DeskSet utilities please refer to the DeskSet Reference 


Guide. 


OPENING A SOUND FILE 
To open an audio file, Double-Select its icon, or Select the icon and drag it onto the 
Audio Tool application. You may also open a sound file using the Load option in the 


File menu in the main Audio Tool window. 


PLAYING A SOUND FILE 

To play a sound, Select and load a sound file and then Select the Play button in the 
main Audio Tool window. Audio Tool can be configured via the Properties option 
from the Edit menu, to play a sound automatically when a file is opened. The volume 
may be adjusted via the Volume menu. SPARCbook 2 does not have an internal 


speaker and so sounds must be played through an external speaker or headphones. 


SOUND RECORDING 
Sounds may be recorded from an external microphone, or other sound source, by 


Selecting the Record button in the main Audio Tool window. 
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SOUND EDITING 

Sound files may be edited via the Display Canvas in the main Audio Tool window. 
This allows you to use the Cut, Copy and Paste keys as you would for text. You can 
also incorporate sounds into an existing file by moving the position pointer in the 
Display Canvas to where you wish the new sound to be inserted, just as would when 
editing text, and then recording. You may incorporate the contents of another sound 


file using the Include File option from the Edit menu. 
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CONFIGURING YOUR 
DESKSET ENVIRONMENT 


When you start up OpenWindows, your DeskSet environment is set up for you and applications can 
be started automatically, ready for you to use. This chapter explains how you can change the 


appearance of the screen and the applications that are started up to suit your own requirements. 
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THE DESKSET STARTUP SCREEN 


When you login, the File Manager and the console window are started by default. For example, you 
might prefer not to use the File Manager, and instead have two command tools come up 
automatically, one as an icon and one ready to use. To do this, you would quit the File Manager and 
set up two command tools, one iconized. When you have your desired set of applications on the 
screen, Choose the Save Workspace option in the Utilities menu. After a few seconds a pop-up 
window will say that your save operation is complete. When you next start-up OpenWindows, your 
workspace will start with the applications active on your screen when the Save Workspace 


command was used. 


WORKSPACE PROPERTIES 


The Workspace Properties window is provided to enable you to taylor the appearance of your 
SPARCbook screen, to change the behavior of the pointer, and to change the display language in 
use. Choose the Properties option from the Workspace menu. The Workspace Properties menu 


contains a Category submenu which allows you access to the following: 


* Color 
This window is displayed by default. It shows a corner of a window, together with a 
block containing the various colors supported by the SPARCbook. You can 
experiment with the options to change the default workspace appearance, and the 


inset window will reflect your changes. 


¢ Icon 
This window allows you to define where the icons for applications and files will be 


placed when they first appear on the Workspace. 


¢ Menus 
This window allows you to change the behavior of Select when opening applications 
or menus. The Select Default option causes the SPARCbook to start up the default 
application from a sub-menu if Select is pressed and released with the pointer over 
the sub-menu’s title in its parent menu. The Display Menu will cause a sub-menu to 
be displayed if Sélect is pressed when over its title. The Drag Right Distance defines 


the displacement on the screen between a menu and its sub-menu when it appears. 
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¢ Miscellaneous 
This window allows you to set the behavior of the beeper. The Set Input Area option 
allows you to define whether a window becomes active if Selected or by moving the 
pointer into it. The Scrollbar Placement option allows you to select the side of a 


window you wish the scrollbar to appear. 


¢ Mouse Settings 
This window allows you to define if the pointer is correctly repositioned when a 
window elevator is moved, and to define whether the pointer is repositioned when 
pop-up dialogue boxes appear. (Selecting the Apply button will demonstrate Pop-up 
Pointer jumping). The Multiclick Timeout option allows you to define the 
maximimum duration between mouse button presses to be considered as a Double- 


Triple- or Quadruple-Select actions. 


¢ Localization 
This window allows you to define the display and input languages in use, and to 


define the format for displaying the date and time, and numbers. 


If you Select the Apply button any changes will be applied to your workspace and saved. You can 


revert to the factory preset values at any time by Selecting the Reset button. 


Workspace Properties 


at 


Category: < | 


| 
workspace | 


_corerawonino 


| Windows 


| Palette 
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131 


CUSTOMIZING OPENWINDOWS MENUS 


CUSTOMIZING OPENWINDOWS MENUS 


Using OpenWindows it is possible to configure your own menus. For example, you might want to 


add a particularly often-used command, or an application, to the main Workspace menu. 


° Open the Top Level Menu Configuration File 


The menu configuration file is called /usr/openwin/1ib/openwin-menu. First copy this 
file into your own directory using the File Manager or the cp command, Rename the new 

file. openwin-menu. From the command line (at the UNIX shell prompt or from the cmdtool 
prompt) this can be achieved with the following commands, which first change directory to the 


default of your home directory, and then copies the file to the new name. 


% cd 


cp /usr/openwin/lib/openwin-menu .openwin-~menu 


oe Ae 


Using a text editor (either the OpenWindows Text Editor or a UNIX editor such as vi from a 


cmdtool1) open the new file for editing. 


~emdtool - /binfcsh — 


+ GH openwin-menu 
# Tadpole 
+ 


f039/14 openwin-menu 


it OpenWindows default root menu file - top level menu 


"Workspace" TITLE 


"Programs " MENU POPENWINHOME /17b/openwin-menu—programs 
"Utilities" MENU FOPENWINHOME “lib/openwin-menu—-utilities 
"PROPERTIES a0” PROPERTIES 

SEPARATOR 

"Portable" MENU POPENWINHOME /1ib/openwin-menu-portable 
SEPARATOR 

“ESS Ear EXIT 


“,openwin-menu" 23 lines, 481 characters 
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° Create a New Entry 
For example, you might add the following line below the Portable entry: 


“My Menu” MENU $HOME/.openwin-menu-mine 


This will set up a new entry called My Menu, and will use the new file specified to determine the 
contents of the new menu. $HOME is a mnemonic that specifies your normal login directory, called 


your home directory. 


° Edit a Menu File if Specified 


If you have specified a new menu file you now need to create it. You can look at the existing 
examples such as the programs menu file which resides in /usr/openwin/1ib and is called 
openwin-menu-progranms for the structure of the new file. To cause a command or application 
to be executed when the menu option is chosen, you end the entry with an exec line. For example, 
suppose that you wanted to set up My Menu to have two options. The first will print the date. The 
second will start up the xfontsel program which can be used to select available system fonts. 


The .openwin-menu-mine file might look like this: 


# 

# After the hash you may place comments 
# My own menu 

# 


“Mine” TITLE PIN # Title and specify a pushpin 
“Date...” exec /usr/bin/date 


“Fonts...” exec SOPENWINHOME/bin/xfontsel 
. Exit and Restart OpenWindows 


In order for Open Windows to use the new configuration it must be restarted. To exit OpenWindows, 
Select the Exit option from the main Workspace menu. When you are back to the prompt or your 
login message, either restart OpenWindows using the openwin command, or log back in. The new 


menu should now be available. 


133 


CUSTOMIZING OPENWINDOWS MENUS 


Modifying Key Mappings 


In certain cases you may need to modify the actions taken by some of the keys. For example, an 
application may use one of the keys designated as Cut, Copy, Paste, etc. for its own purposes. Often 
the application itself will provide facilities to remap its use of the keys, and you should refer to the 
application manual for further information. However, it is possible to modify the standard key 


mappings from the operating system. 


To do this, first copy the file /usr/openwin/1ib/Xdefaults into your own directory using 
the File Manager or the cp command. Rename the new file. Xdefaults. To do this from a 
Command Tool, rather than the File Manager, you would type the following commands to the shell 


% or $ prompt. 


% cd 


% cp /usr/openwin/lib/Xdefaults .Xdefaults. 


Text Editor ¥3 - .Xdefaults, dir; /usr/export/home/juno/ds 


See Fe Edie re yi: hd 
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This changes directory to your home directory (in case you were not already there) and copies the 
file. Using a text editor (either the OpenWindows Text Editor or a UNIX editor such as vi), open 
the new file for editing. The file may not look exactly as shown, but will be similar. This file 
configures your default X Window environment. To change the key used by a particular function, 
you should change the mapping in this file. For example, to move the Copy key to its location on a 
Sun type-4 keyboard you need to change the mapping for Copy from F9 (its position on the 
SPARCbook keyboard) to L6 (its position on the Sun keyboard). The SPARCbook key mappings 
include definitions for key equivalents called L1 to L12 and R1 to R12. These simulate the Left and 
Right function keys on larger keyboards and are obtained using the Alt-Fx and Fn-Fx key 


sequences respectively. You can, therefore, make the following change: 


OpenWindows .KeyboardCommand.Copy:F9 


to 


OpenWindows.KeyboardCommand.Copy:L6 


To make the changes take effect without having to exit OpenWindows, you need to change your X 


resources using the xrdb command as follows: 


% cd 

% xrdb .Xdefaults 
The next time you start up OpenWindows the new .Xdefaults file will automatically be read in 
and so you only need do this command once. If you follow the example above, the Copy key will 
now be Alt-F6 and not F9. To revert to the factory defaults, you can delete or rename your 


-Xdefaults file and restart OpenWindows. 


UTILITIES 


The Utilities option in the main Workspace menu provides a set of useful options. 


¢ Refresh 
will cause the screen to be redrawn. This is necessary if the display becomes 


corrupted for some reason. 


135 


UTILITIES 


Reset Input 
can be used to restart input if the system does not respond to your typing. This is 


usually due to a command or application not operating correctly. 


Function keys 
displays a pop-up window with the Function keys displayed from F1-F12. Selecting 


these has the same effect as pressing a Function key. 


Window Controls 
is a sub-menu that allows you to select basic window operations for the selected 
window. If you wish to use this, it is easiest to pin it to the workspace so it is always 


accessible. 


Save Workspace 
allows you to save the current applications and positioning of windows so that when 


you next use OpenWindows the environment will be the same. 


Lock Screen 
will cause the screen to blank showing a pattern. You must enter your password to 


unlock the screen. 


Console 
should be used to bring up a Console terminal window if you lose the default console. 
The Console is used to print warning or error messages that are detected by the 


system. You should not have more than one console running at any one time. 


Mousekey 

has a submenu with two options. Reset will recalibrate the Mousekey. This sets the 
current Mousekey values assuming the key is not being pressed and may be used if 
the mouse drifts or is uneven. Parameters will display a pop-up window allowing you 


to adjust the mouse sensitivity and constraints. 


Restore Stipple 
may be used to restore the background stipple effect on the display after using 
Properties from the Workspace Menu, which sets the background to the selected 


color. 
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POWER MANAGEMENT 


SPARCbook 2 is designed to operate from batteries for typically 1.5 hours on a single charge. 
Various power management techniques are used in the design of the system to extend the normal 
battery life to the maximum possible time. However, there are several facilities provided which you 
can use to influence and extend the battery life. This chapter describes the Power Management 


facilities as well as basic operations like changing an recharging the battery. 
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THE BATTERY MANAGEMENT SYSTEM 


The SPARCbook system has a battery monitor to detect the battery level. In order for this to operate 
correctly the external power supply must be either disconnected or switched off, since the monitor 


only operates correctly when the battery is being used. 


The charge level of the battery can be observed using the Battery Monitor by Choosing the Battery 
Level option in the Portable menu from the main Workspace menu. After a short wait the Battery 
Level window will appear showing the level of the battery. The Battery Monitor is a sophisticated 
utility which monitors the charge level of the internal battery. It operates on statistics gained by 


monitoring the battery charge and discharge characteristics over the lifetime of a battery. 


| level 


Battery 
\y 100% 


Because of the discharging characteristics of Nickel Cadmium batteries, the bar display is most 


accurate at the top and bottom (i.e. when the battery is nearly fully charged or nearly discharged). 


While this description primarily relates to OpenWindows, it is possible to obtain the 


battery level from the Solaris command prompt. The command battery will report 
the battery level as an estimated percentage of charge left in the battery to the nearest 


10%. 


Battery Monitor is able to maintain statistics for up to eight different batteries, allowing you to 
exchange batteries and still have accurate information about the charge level for each. To use this 
facility you should assign each battery a number via the Use option in the Battery Monitor menu 
and label each battery with its number. Each time you change the battery you should Choose the 


number assigned to it from the Use option. 


You can observe the current battery number by dragging the pointer beyond the list of battery 


numbers while still pressing Menu. 


138 


BATTERY LOW WARNING 


If you are assigning a new battery to a previously used number, you should Reset any information 


held for that number. 


| lev 


Batte ose 
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BATTERY LOW WARNING 


The SPARCbook system monitors the battery level and provides you with two warnings as the 
battery charge level drops. The first warning occurs when there is about 20 minutes of battery 
operating time left. This warning appears as a message on the Console window. In addition, the Red 
LED marked with a battery symbol on the top left hand side of the system starts to flash. At this 
time, you should connect the external charger/adapter into the back of the unit to power the system 
and to recharge the battery. You will be able to continue using the SPARCbook while the battery is 
being charged. Alternatively, you should use the Save and Resume facility to shut down the 


computer and replace the battery if you have a spare. 


BATTERY CHARGING 


The only way of recharging the internal battery is to connect the external charger. The system may 
be on or off while the battery is being recharged, but the charging will be faster if the system is 
turned off. The battery takes 2.5 hours to recharge if the system is off and about 6 hours to recharge 


if the system is being used. 
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The SPARCbook uses temperature sensing as the primary method of detecting when 
the battery is fully charged. When the battery temperature reaches 43° Celsius the 
charging is switched into trickle mode. To fast charge the battery successfully the 


ambient temperature should be less than 35°C. 


When the charger/adapter is plugged in and is not fast charging it will automatically trickle charge 


the battery pack, maintaining it at full charge. You will not cause any problems by leaving the 


charger connected to the system for extended periods of time. 


REPLACING THE BATTERY 


The battery is specially designed for SPARCbook computers. Spare packs are available as product 


options from your SPARCbook supplier. Before removing or changing the battery first ensure the 


system is off and the main power supply is disconnected. 


Do not remove the battery while the system is running. If you do so data files are likely 
to be corrupted and, in an extreme case, you may not be able to restart the system due 


to disk file corruption. 


Caution - Batteries may explode if mistreated. Do not short circuit the battery contacts 
or allow them to come into contact with metal objects. Always fit the end cap to a 
battery when not fitted in the SPARCbook. Do not mutilate the battery or dispose of it 
in a fire. Do not attempt to recharge the battery other than in the SPARCbook or with 


an approved battery charger. 


Remove the battery as follows. Using a coin rotate the battery door latch slightly (by less than a 


quarter turn). The door should pop open and the battery will be clearly visible. Pull the battery 


straight out of the battery compartment. 


You will not cause any damage to the SPARCbook by operating it from the external 
adapter without a battery installed. However, operating the SPARCbook in this way is 


not recommended since it may cause unreliable operation. 
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To insert a new battery, ensure that the metal contacts are inserted first and that the battery is 
oriented correctly (it can only be inserted one way round). Insert the battery into the compartment 
until it is level with the battery door, and use the door to seat the battery home. Press firmly on the 


battery flap and the internal spring catch will automatically hold it shut. 


EXTENDING BATTERY LIFE 


To reduce power consumption, the SPARCbook 2 automatically stops the processor clock and 
peripheral devices when they are not being used. SPARCbook 2 provide a DeskSet tool called 


Power Manager which provides you with several ways to influence battery life. 


The various power management functions can be customized to meet specific requirements. In 
order to set up preferences you may use the OpenWindows environment. To do this Choose the 


Power Manager from the Portable menu and after a short wait a window will appear with the 
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various options detailed above. Using the Select key and the pointer you can set the configuration to 
meet your requirements. If you are uncertain about the OpenWindows operation refer to the chapter 
“‘DESKSET USER INTERFACEP’. 


a . ‘powermgr a 
Disk Spindown = =2mins — : es EO gy 
: : 2 a [ le 
: Oo mins oo 15 mins 
Display : [ee E— | 
i i { Ie I 


Dark Bright 
Screen Saver 5 mins J — | 
t i ! 


oO mins 15 mins 


System Shutdown 75 mins dC ——— 
Peeve Bebe: hedeeis be pest 


oO mins 60 mins 


Slow | 


Shutdown on powerlow 


Save power while charging | 


Apply} _Reset ) 


* DISK SPIN DOWN 
After a selectable period of disk inactivity, the hard disks are independently spun 
down to the idle state. When an idle disk is accessed there is a delay of about 3 


seconds while it spins up. The Disk Spin Down period is set by default to 2 minutes. 


¢ DISPLAY BACKLIGHT 
After a selectable period of keyboard and mouse inactivity, the display backlight is 
turned off. The backlight is automatically turned back on when a key is pressed. The 


period is set by default to 5 minutes. 


The LCD display backlight consumes about 20% of the power used by the system. If 


you operate on reduced brightness (by using the keyboard Alt- | sequence, or the 


Preferences tool described below) you will considerably extend the battery life. 


142 


EXTENDING BATTERY LIFE 


¢ SYSTEM SHUT DOWN 
After a selectable period of keyboard and mouse inactivity, the system will turn itself 
off to conserve power. By default this period is set to 15 minutes. You can disable this 
facility completely via the Preferences option in the Portable menu, described on the 


next page. 


« SLOW MODE 
To conserve power you can run the system at one half the normal speed. System 
peripheral functions such as disk operations continue to function at the normal speed, 
but the processor and memory are run at half speed. This mode is useful for 
extending battery life when doing tasks that require little processing power — for 
example word processing. Running in slow mode will extend the system battery life 


by up to 30 minutes. 


« SHUTDOWN ON POWER LOW 
This facility protects against operating system and file corruption caused by battery 
exhaustion. When SPARCbook 2 detects that the battery is nearing exhaustion, it 
saves the complete machine state to the disk, and then performs a system shutdown. 
Replacing the battery or connecting the external power supply (which also recharges 


the battery) and then switching the SPARCbook 2 back on, causes it to Resume. 


* SAVE POWER WHILE CHARGING 
This facility can be used when SPARCbook 2 is powered externally. When this 
option is enabled, and after a period of inactivity, SPARCbook 2 switches the display 
backlight off and spins the disks down, allowing faster battery charging. Normal 
operation is restored when a key is pressed. After a prolonged period of inactivity, 
SPARCbook 2 performs a system shutdown. Pressing the ON switch causes 
SPARCbook 2 to Resume. 


To set up your new choices, Select the Apply button. If you wish to return to the factory defaults at 
any time, you can Select the Reset button. When you have set up the required configuration, Select 


the pushpin to remove the window from the screen. 


It is also possible to perform the same power management functions from the system shell prompt. 


To adjust the settings from the Solaris shell use the following command: 


pwrman-dishm][-screem][-offh] [-slow] [-normal][-reset] 
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n sets the required time in seconds for each mode referred to above. 
A value of zero causes the mode never to be entered. 
normal turns the slow mode off if it has been enabled. 


reset returns the power management functions to their factory defaults. 


If you override shutdown on power low, you run the risk of corrupting data files. These 
files may not be recoverable and, in extreme case, you may have to reload (or rebuild) 


the operating system on your hard disk drive. 


The SPARCbook 2 provides two operating modes for the integral LCD display. These are 512- or 
4096-color mode, which display 256 colors simultaneously from a palette of either 512 or 4096 
colors. While operating in 4096-color mode provides better color definition, operating in 512-color 
mode consumes less power, see ‘Enabling an External Display’ on page 153 for information about 


mode selection. 


FACTORS AFFECTING BATTERY LIFE 


Overall battery life depends on many factors, such as operating temperature, charge/discharge 
cycles and usage patterns. The SPARCbook battery is designed to operate at up to 80% of its initial 


efficiency for up to 1000 complete charge/discharge cycles. 


The SPARCbook battery utilizes the latest generation of Nickel Cadmium batteries. You may partly 
discharge the battery on a regular basis with no effect on overall charge capacity or battery life. You 
do not need to deep discharge the batteries at any time, and trickle charging with the external 
charger/adapter may be maintained for extended periods. Eventually, however, the battery will wear 
out after typically around 2000 hours of portable use. The charge life will become shorter and 


shorter until eventually you will need to replace the battery. 


You should be careful in disposing of Nickel Cadmium batteries since they contain 
substances harmful to the environment. Your SPARCbook supplier will be pleased to 


accept returned batteries for safe recycling. 
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Configuring a Local Printer 


Remember that the SPARCbook can be used as a networked machine. You may easily 


connect to printers on remote SPARCbook or other UNIX based machines. For further 


information on remote printers see ‘Configuring a Remote Printer’next. 


In order to carry out the following procedures you need to have superuser privileges. Either login as 
root, or if you are doing the printer setup from the OpenWindows environment you can open a 
terminal window by Choosing the cmdtool option from the main Workspace menu, and type su to 
obtain superuser access. You will be asked to enter the root password, and the prompt will change to 
a ‘# symbol, to remind you that you now have superuser status. When you have finished the 


administration operations type Ctrl-D to revert to your normal privilege level. 


. Connect the printer to SPARCbook 2 and ensure that it is turned on. 
° Check basic data communications between the SPARCbook and the printer. 
Type: 


# (stty [options]; cat /etc/motd) >/dev/serial 


Options are one or more of the following: 


baud baud rate e.g. 1200, 9600 etc. 
-evenp set even parity (default) 
-oddp set odd parity 

-parity no parity 

-tabs convert tabs to spaces 

-onlcr output CR-LF for CR or NL 


If all is well the /etc/motd file should be printed out on your printer. If you experience 


difficulties refer to ‘Printer Problems’ below. 


. Set up the printer system files 


You must first createa /etc/printcap file entry for the printer or printers you are using. Using 
the Text Editor in OpenWindows, or a UNIX command line editor such as vi, edit the file 


/etc/printcap. 
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The example below adds a printer to the system, connected to the serial port. It is assumed to be an 
Epson MX-80 printer configured to operate at 9600 baud, with no parity, and hardware rts/cts 
handshaking enabled. The following lines would be added to the /etc/printcap file: 


# Epson MX-80 Dot Matrix printer 

epson|mx-80|dot matrix|epson mx80:\ 

lp=/dev/serial:br#9600:\ 

ms=-parity,crtscts: sd=/var/spool/serial: 
This specifies a serial printer on the /dev/serial line. The br option specifies the printer baud 
rate. The ms option specifies the line characteristics chosen from the available st ty utility options. 
The most often used options were specified on the previous page. The crt scts entry specifies to 
use hardware rts/cts handshaking. Note that a different spool directory is required, and that this 


must be created next. 
Other parameters are useful for printcap descriptions are: 


mx#0: set maximum file size unlimited. This is useful for PostScript 
printers where the default of 500 Kbytes can easily be exceeded. 
However, beware of system disk space limitations when printing 


large PostScript files. 


pl#x: printer page length is x lines (default 66) 
pw#n: printer page width is n characters (default 132) 
° Create any required spool directories 


By default, the system includes a spool directory /var/spool/1pd for temporary storage of 
files as they are being printed. If you specify more than one printer you will need to create a spool 
directory for each additional device. Using the example above you would need to do the following 


as superuser to set up the /var/spool/serial directory: 


# cd /var/spool change to spool directory 

# mkdir serial make a new spool directory 

# chown daemon serial _ change owner to printer daemon 
# chmod g+w serial set file mode 


You will need to do the same with any other required printer spool directory using your specified 


name rather than ‘serial’ used in the example. 
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If all is well you should now be able to print files to the printers you have set up using the 
OpenWindows Print Tool program, or using the Solaris lpr command. If you have difficulties refer 


to ‘Printer Problems’ below. 


Configuring a Remote Printer 


If your SPARCbook is connected to a network, you may use printers that are connected to other 
machines on the network by specifying a slightly different /etc/printcap description. The 
following lines might be added to the printcap file to enable printing to a remote machine called 


jupiter with an attached LaserWriter printer. 


# Laserwriter on Jupiter 
lwriter|lw|laser-writer: \ 
:lp=:rm=jupiter:rp=lw:sd=/var/spool/juplp: 
All remote printers have the 1p= field. The rm field specifies the hostname of the remote machine 
to use, and must be known to the local system as an accessible machine on the network. rp 


specifies the remote machine printer name (in this example 1w). 


Ensure that you create the spool directory as detailed in the previous section. 


Printer Problems 


If you have followed these instructions, everything should work first time. This section gives some 
limited advice on what to do if something goes wrong or if the printer does not work. For further 
software information, you will need to refer to the complete Solaris documentation. For further 
hardware information, refer to your printer manual and the pinout descriptions in the chapter 
“TECHNICAL REFERENCE AND FURTHER READING’. 


If everything appears to be working but there is no output to the printer when you try to access it 


directly using /dev/serial, check the following: 


¢ The printer is plugged in and switched on. 

* The cables are correct for the SPARCbook and the printer. If the printer cable is not 
exactly correct for the printer hardware setup then printing may not be enabled. 

¢ Try the printer self-test if there is one. 


¢ The baud rate and data settings for the printer and the computer match. 
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If a serial printer appears to be printing but is producing garbage or incorrect characters check the 


baud rate and data settings again, since this is the most likely cause of the problem. 


If the Print Tool or lpr command does not work but direct printing does, then an error message 
may be printed out on the screen or in the console window. 
lpr: [printername]: unknown printer 
The specified printername was not found in /etc/printcap. 
Check you have set up this file (see above). 
lpr: [printername]: jobs queued, but cannot start daemon. 
The printer daemon has stopped. Try running the 1pd program as 


superuser: 


$ su 
# /usr/lib/1pd 


starts the line printer daemon 


waiting for printer to become ready (offline?) 


The printer device could not be opened. Typically, the printer is off- 
line or not connected. You may need to stop the print job and then 


restart it after connecting a printer, or putting it on-line. 


waiting for [hostname] to come up 


The software cannot find the remote printer. Either the Ethernet 
connection is not operating or the printer daemon on the remote 
machine has stopped. Check you can communicate with the remote 


machine. You may need to stop the print job and restart it. 


If there is still no printer output you should consult your printer manual for further assistance. 
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CONNECTING AN EXTERNAL DISPLAY 


The SPARCbook system can be used with an external color display. This section explains the types 
of display supported, how to physically connect one to the SPARCbook, and how to operate the 


system when a display is connected. 


The SPARCbook system will consume more power when an external display is being 


driven. It is recommended that you connect the SPARCbook to the external charger/ 


adapter when using an external monitor. 


SPARCbook 2 can drive many standard color monitors intended for Sun or compatible computers. 
On an external display, SPARCbook 2 is able to display 256 colors simultaneously from a palette of 
over 16 million shades. It is possible to drive the internal LCD flat panel display and an external 


640 x 480 pixel VGA display simultaneously. The display formats supported are as follows: 


* 640 x 480— VGA, with simultaneous display enabling. 
¢ 1024 x 768 — Sun XGA, internal display disabled. 
¢ 1152 x 900 — Sun compatible, internal display disabled. 


== W000 in ))) om) 


Display Interface 


SPARCbook 2 provides an IBM PS/2 style 15-Pin D type connector on the rear panel. The display 
interface provides a VGA compatible signal interface and allows direct connection to VGA and 


XGA displays. If you wish to connect a Sun compatible display, you may connect it via a 15-pin D 
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type to DB13W3 adapter cable supplied with the SPARCbook 2 system. The pinouts of the display 
interface connector on the rear of the SPARCbook 2 system and on the Sun display adapter cable 
are provided in the chapter ‘TECHNICAL REFERENCE AND FURTHER READING’. 
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Enabling an External Display 


To enable the display interface from OpenWindows you should Choose the appropriate option for 


the connected monitor from the Workspace Portable menu, as shown below. 


Portable 


/ Battery Leys 


‘Internal (512 colors) 
External K Internal (4096 colors) 
Change Ti External ¥GA Only 
POPtool., Sun 1152x900 66H2 
SLIPtool. Sun 1152x900 76HZ 

Sun 10248768 76H2 


The SPARCbook 2 system is able to operate the internal display and an external VGA 640 x 480 
display simultaneously. The internal display will operate in 512- or 4096-color mode, but will not 
drive an external monitor while in 4096-color mode. Also, enabling one of high resolution external 
monitor modes has the secondary effect of turning the internal display off. SPARCbook 2 always 
starts up with the internal display enabled and the external display disabled, to prevent you from 


operating the SPARCbook 2 system with a blank screen and without an external display connected. 


The default setting when the SPARCbook 2 is shipped is Internal (512 Colors). 


You may also turn on the external monitor from the Solaris command prompt. The 


command extvga 1 will turn the external VGA monitor on. 


Adding to the External Display Menu 


The External Display menu on a new SPARCbook 2 contains options for some of the most 
commonly used VGA and Sun compatible monitors. However, SPARCbook 2 is able to support a 
wider range of external display monitors than is listed in the External Display menu. The Solaris 


Operating System uses the file /etc/fbconfigurations to create the External Display menu. 
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It is possible to add a menu option for your own display by editing /etc/fbconfigurations 


using vi or Text Tool. To do this, you will need to be logged in as root. 


‘Text Editor ¥3-fbconfigurations,dir;/etc = 


File © ) 


Edit =) Find © 


#! ‘(bin/sh 
4, 


# GG Foconfigurations,sh 1.3 93/02/11 Tadpole 
if 

# Copyright (c) 1993 by Tadpole Technology 

iF 


#! ¢’bine’sh 

fl 

# this file serves two purposes; it defines the standard video 
dt configurations and provides ythe basis for contructing the 
external 

# display menu for OpenWindows 

i 

it The format of the file is the menu text as 4FMENU text followed 
# by the fbconfig line for that entry 


it 

it 

MENU Sun 1415 Z 

fbconfig -n ; 900 92,940 29 128 195 2 4 31 cr 
iF 


MENU Sun 4152x900 
fbconfig -n 4 44 56 
# vfront/usyne should be 2 

i 

dEMENU Sun 1024: 


24 31 cr 


iF 


Each entry consists of a line of text as it will appear in the menu, followed by a line that defines the 


operating parameters for the display. To add an entry for a new display you need to add two new 


lines. 
ee You should consult the technical manual for your external display to determine the 
NOTE ie 


required operating parameters. You should also consult the chapter ‘TECHNICAL 
REFERENCE AND FURTHER READING’ for pinout details of the SPARCbook 2 


display interface connectors. 
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For example, an entry for a 1024 x 768 display with a screen refresh rate of 60 Hz might look like 
this: 


#MENU My Display 1024x768 60Hz 
fbconfig -n 6 1024 768 64.125 16 128 160 2 6 29 r 


Then you will need to instruct the SPARCbook 2 to rebuild the External Displays menu by entering 


the following command in the Command Tool window: 
# /usr/openwin/bin/mk-openwin-displays 


The £bconfig command can also be entered at the Solaris command prompt. 


However, it will not then appear as a menu entry. 


The syntax of an fbconfig entry is as follows: 


flbconfig -n mode width height frequency hfront hsync hback vfront vsync vback [flags] 


-n mode This creates a new display mode. Modes 0, | and 2 are reserved, 
and modes 3, 4 and 5 have been set up already for your 


convenience. You should start additional modes from 6. 


width This is the visible screen width in pixels. 
height This is the visible screen height in lines. 


frequency This is the dot clock frequency, i.e. it determines the rate at which 


pixels are output to the monitor. 


hfront This parameter determines the duration in pixels of the screen 
blanking period between the end of a line of visible video data and 


the start of the horizontal sync pulse. 
hsync This is the duration of the horizontal sync pulse in pixels. 


hback This parameter determines the duration in pixels of the blanking 
period that occurs between the end of the horizontal sync pulse and 


the start of a line of visible video data. 
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vfront This parameter determines the duration in lines of the blanking 


period between the end of a frame of visible video data and the start 


of the vertical sync pulse. 


vsync This is the duration of the vertical sync pulse in lines. 


vback This parameter determines the duration in lines of the blanking 


period between the end of the vertical sync pulse and the start of the 


next frame. 


flags These allow you to set the SPARCbook 2 display interface to 


operate as required by the external monitor as follows: 


c 


g 
p 


Enable composite sync (required for most Sun monitors) 
Enable composite sync on green 

Enable extra blanking pedestal to enhance the difference 
between blank and black. 

Enable positive sync pulse. The horizontal sync pulse is 
normally negative 

Enable vertical sync pulse. The vertical sync pulse is 
normally negative 

Set the read-only flag. Once the read-only flag is set, only a 


restarting the SPARCbook will clear it. 


The operation of the display interface hardware in SPARCbook 2 is fully software controllable 


enabling you to attach wide variety of displays. However, the architecture of the internal display 


interface hardware imposes a number of constraints on the values that may be used with the 


fbconfig command, which are summarized in the table opposite. 
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"PARAMETER MIN | MAX STEP 
| Display width ; Q 128 pixels 
Display ovidith x height . | - | 1048576 | 
| Dot (pixel) clock frequency i 8 MHz af OS MHz | - ; 
Horizontal front porch 4 fel | 60 pixels | 4 
| Horizontal ene eile + | 252 + : 
| Horizontal back = ; a 252 ft 
| Vertical front porch | | ; 3 
Vertical syne pulse . | fi - 
i Vertical back porch l 63 - 
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CONNECTING AN EXTERNAL KEYBOARD AND 
MOUSE 


The keyboard and Mousekey in SPARCbook 2 are designed for portability. However, it is 
sometimes convenient to be able to use an external keyboard and mouse while at your permanent 
place of work. The combined Keyboard and Mouse interface on the rear of the SPARCbook may be 


used to connect a type 4 or 5 Sun keyboard and mouse. 


dint mt) om) 


Combined 
Keyboard and Mouse 
Interface 


SPARCbook 2 only supports the connection of Sun compatible keyboard and mouse. 
You may use an optical or mechanical mouse. PS/2 type mice and keyboards should 


not be connected. 


The pinout of the Combined Keyboard and Mouse interface is completely standard, allowing you to 
connect Sun compatible external mice and keyboards with the cables supplied with them. The 
combined Keyboard and Mouse Interface allows you to connect an external mouse on its own, an 


external keyboard on its own, or both simultaneously. The mouse may be connected directly to the 
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SPARCbook 2 or indirectly via a connector on the external keyboard, as illustrated below. The 
internal Mousekey and keyboard remain active while an external keyboard and mouse are 


connected. 


Using International Keyboards 


The SPARCbook 2 may be obtained with a non-US keyboard layout. It is possible to use an 
external keyboard with a different layout to the built-in keyboard, but one of the two keyboards will 
not respond with the characters engraved on the key tops. For example, if an external French 
keyboard is used with a SPARCbook which has a built-in US keyboard, the system may be 
configured to provide either a French or US virtual keyboard but not both. In this situation it is 
advisable to return the virtual keyboard type to that of the internal keyboard before powering off 
(Save or shutdown) if the SPARCbook is likely to be used without the external keyboard when you 


next power-up. 
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For the console interface and OpenWindows, the layout selected will be detected automatically. The 
SPARCbook has two possible sources of keyboard input: the internal keyboard, and the Keyboard 
and Mouse interface. The kbconfig command allows the keyboard layout to be changed. There is 
a layout code for the built-in keyboard and for the target layout (the virtual keyboard). The layout 


codes used are those defined for Sun Type 4 and Type 5 keyboards as follows: 


CODE NATIONAL TYPE CODE NATIONAL TYPE 
0 US Type 4 33 US Type 5 

l US Type 4 34 US Type 5 

2 French/Belgium Type 4 35 French Type 5 

o' Canada Type 4 36 Denmark Type 5 

4 Denmark Type 4 37 Germany Type 5 

5 Germany Type 4 38 Italy Type 5 

6 Italy Type 4 39 Holland Type 5 

| Holland Type 4 40 Norway Type 5 

8 Norway Type 4 4] Portugal Type 5 

9 Portugal Type 4 42 Spain Type 5 

10 Spain/Latin America Type 4 43 Sweden Type 5 

1] Sweden/Finland Type 4 44 Swiss French Type 5 
12 Swiss French Type 4 45 Swiss German Type 5 
13 Swiss German Type 4 | 46 UK Type 5 

14 UK Type 4 
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The command used to select a keyboard layout is as follows: 


# kbconfig [-r] [-it layout] 


-r Reconfigure the keyboard. This option can be used to cause the 
operating system to perform the same keyboard configuration as it 


does at boot or Resume. 


-i layout -t layout 
One of these options may be used to set the internal layout or target 


keyboard layout to one of those shown in the table. 
The current settings can be obtained by using the kbconfig command without arguments. 


The layout of the SPARCbook’s built-in keyboard is factory set to one of the Type 5 layouts. The 

key code conversion in the operating system uses this code to determine the difference between US 
(layouts 0, 1, 33 and 34) and non-US keyboards. These differ in that the two keys marked Ins and 
Del on the US version are modified to show national language symbols on the Ins key and both Del 


and Ins on the Del key. The target layout is factory set to be the same as the built-in keyboard. 


Keyboard auto-configuration is performed automatically when you restart the SPARCbook. If a 
keyboard is connected while the system is running, then it should be configured and enabled with 


the command: 


# kbconfig -r 


The command to set the target layout to US Type 5 would be: 


# kbconfig -t 33 


For the console to take note of this change, the loadkeys utility must be run after kbconfig. 
For OpenWindows to take note of the target layout change, you must exit and then restart it. The 
target layout for the virtual keyboard which will be seen by utilities and OpenWindows may be set 


to any of the layout codes, but will usually match that of the built-in keyboard layout. 
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There are codes for a range of non-US keyboard layouts. If you wish to change between non-US 


keyboard layouts, you must change to the US layout first. For example if the current layout is 37 


(German) and the new layout is to be French you would type: 


Ke 


A= > 


# kbconfig -t 33 
# loadkeys 
# kbconfig -t 35 
# loadkeys 


SPARCbook 2 uses the Alt and Fn keys in combination with others to access the Sun 4 
and 5 L and R keys, as discussed in ‘Introduction to SPARCbook’. This mapping may 
be disabled using the command: 

# kbconfig -c 1 

This causes the Alt and Fn keys to be treated as modifiers, necessary if you are running 
Motif instead of OpenWindows. The normal mapping for SPARCbook 2 can be 
restored with the command: 


# kbconfig -c 0 
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CONNECTING AN ASCII TERMINAL 


A conventional ASCII terminal can be connected to the SPARCbook serial I/O port to give an 
additional login port. The SPARCbook supports serial I/O devices with RS232 interfaces at baud 
rates from 300 to 38400 baud. By default the serial port is not enabled as a login port, to allow it to 
be used as a printer port. This section describes how to connect a serial terminal to the SPARCbook 


and how to configure it as a login port. 


The SPARCbook is an FCC registered Class B device. If you connect a peripheral to it 
that is not Class B registered the entire system becomes a Class A device and should 
not be used in a residential area. You should take care to use only Class B registered 
devices in a residential area and you should ensure that all peripherals connected to the 


SPARCbook do so with fully shielded cables. 


° Connect the Terminal to the SPARCbook 


The SPARCbook serial port requires a cable from the port to the terminal. This cable depends on 
the terminal being used. The chapter ‘TECHNICAL REFERENCE AND FURTHER READING’ 
gives details of the SPARCbook serial port connector pinout and gives details of the construction of 
commonly required cables. You may also need to consult the technical manual for the terminal you 


are using. 
. Enable a Login port and Set the Baud Rate 


To enable the SPARCbook serial port for a second login you must tell the Operating System that the 


serial port is to be used as a login port. To do this you will need to be logged in as the superuser. 


Using the OpenWindows Text Editor or a UNIX editor such as vi from the cmdtool1 interface 


edit the file /etc/ttytab. The first few lines of this file are shown below: 


# @(£)ttytab 1.6 89/12/18 SMI 

# 

# name getty type status comments 
# 

console “/usr/etc/getty std.9600” sun on local secure 
ttya “/usr/etc/getty std.9600” unknown off local secure 
ttyp0 none network off secure 
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To enable the serial port for a log in from an attached terminal you need to change the of f status 
for the tt ya line to on. Once you have made the change you should save the file and exit the 


editor. 


Next you must tell the Operating System to reread the /etc/ttytab file. To do this, enter the 


following command to the command tool or shell prompt: 


# kill -1 1 


This command will enable the serial port for a login from a connected terminal or other serial 
device. If you have connected the serial port cable correctly, the system should respond with a login 
message when you press Enter or Return on the terminal keyboard. If the terminal is set up for a 
speed other than the initial speed used by the system, the SPARCbook will change baud rate after 
each character is sent until it sees the correct rate. You may need to press Enter or Return several 


times to obtain a prompt if the baud rate is not correct. 


Whenever you shut down the system and restart it, the login port will be available on the serial port 


line. 


. Disable a Login port 


If you have enabled the login port and at a later date want to change the usage of the port back to a 
normal port for a printer or other serial I/O device not requiring a login you should reedit the 
/etc/ttytab file and change the on status for ttya back to of f. You will then need to tell the 


system again by executing the same kill -1 1 command. 
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CONNECTING AN X TERMINAL 


You may connect a third party X Window terminal to the SPARCbook using the integral Ethernet 
interface. An X terminal allows you to have a second port into the SPARCbook with graphics 
capability. You should follow the instructions provided with X terminal on how to interface it to the 
SPARCbook and how to configure the software interface. You should also refer to ‘Configuring the 


Network’ for information on how to connect and set up the network interface. 


X Terminals have an integral X Window Server allowing them to display graphics. 


They then connect over Ethernet to the SPARCbook clients. The clients, or 
applications, send standard protocol sequences over the network to the connected 
terminal. In this way it is possible to run OpenWindows and other SPARCbook 
facilities over the network. However, you should remember that you will not be able to 
use any of the display PostScript facilities of the SPARCbook on the X terminal since 
the SPARCbook PostScript support is built into the NeWS server. For example, you 
will be able to use the basic FAXtool facility but you will not be able to use the 


Preview facility in the FAXtool from an attached X terminal. 
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CONNECTING EXTERNAL SCSI DEVICES 


SPARCbook 2 provides a SCSI interface which allows you to expand the data storage capacity 
easily. A wide range of storage devices are available from third party vendors, including CD-ROM, 
hard disk and tape streamers. Five or six devices may be connected to the SPARCbook 2 system, 
depending upon whether the SPARCbook 2 system has one or two internal drives. The SPARCbook 
2 system provides a 36-pin micro miniature D-type connector on the back panel and a break-out 
cable is supplied with the system to allow you to connect to external devices with a Sun type SCSI 
cable. The pinout for the back panel connector and the break-out cable are provided in the chapter 
‘TECHNICAL REFERENCE AND FURTHER READING’. 


The signals from SCSI connector on the rear of the SPARCbook 2 system are not 
compatible with the signals from a similar style connector on the rear of the 
SPARCbook | and LC models. Do not use cables intended for SPARCbook land LC 
units with SPARCbook 2 or vice versa. Do not connect the SCSI Interface Adapter 
supplied for SPARCbook land LC to the SPARCbook 2. Failure to observe this 


warning may result in serious damage to your SPARCbook 2 system. 


Connecting SCSI Devices 


The break-out cable supplied with the SPARCbook 2 system allows you to connect to a SCSI cable 


device with a 50-pin micro miniature D-type connector. 


SPARCbook 2 supplies the SCSI terminator power signal (termpower) which must be present for 
the SCSI system to work. You can check this by plugging a Sun terminator into an unoccupied 
SCSI socket on the rear of a connected peripheral and applying power. If the LED built into the 
terminator illuminates then termpower is present on that device and the system should work. Other 


devices on the SCSI bus may supply it as well without causing problems. 


The SCSI device to which you are connecting should have two sockets. Both should be 


occupied. One should be occupied by the connection to the SPARCbook, and the other 
should either connect to another SCSI device or should have a terminator plugged in. 
You may connect up to seven devices in a series, but the last one must be terminated. If 


you are in doubt please consult the manual for your SCSI device. 
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SCSI Interface 


Configuring the SCSI Bus 


The external SCSI peripherals may be daisy chained (connected in series) on the SCSI bus as long 
as a terminator is attached to the last physical device on the chain, and each device has a unique 


SCSI ID (or target ID). The SPARCbook 2 contains internal terminators which cannot be removed 
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and so must always be connected at one end of the daisy chain. Many SCSI devices provide a 
switch on the rear which allows you to select its target ID using either a ball-point pen or your 
thumb. The target ID that should be selected for a particular device when used with the 
SPARCbook 2 system depends upon its type. The SPARCbook 2 Operating System provides device 


names for a number of SCSI device types using the following ID’s: 


DEVICE DESCRIPTION TARGET ID 
sd0 [First SCSI hard disk* ; 7 = 
sdl Second SCSI hard disk* - 
sd2 Third SCSI hard disk 2 
sd3 Fourth SCSI hard disk 0 
st0 First SCSI Tape drive 4 
stl Second SCSI tape drive 5 
srO First CD-ROM drive 6 
sr] Second CD-ROM drive 2 


a. Always fitted internally 

b. Reserved — do not use 

c. Optional internal drive 

d. Reserved if optional drive fitted internally 


Target ID 7 is reserved for SPARCbook 2 itself. 


To access data on an external SCSI drive it is necessary to mount it on the file system. For example, 
for a hard disk drive with a SCSI ID of 0, from the table above, this would be carried out from the 


superuser account using the commands: 


# cd / 

# mkdir /scsihard 

# mount /dev/sd3 /scsihard 
# 


The SPARCbook 2 will automatically detect the presence of SCSI peripherals when an attempt is 


made to access one. 
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Units Without Hard Disks : 


The SPARCbook 2 may be specified for shipment with no internal hard disks fitted. This type of 
system should have an external disk connected to it via the SCSI before it is powered up. Although 
you will not cause damage by powering without a SCSI disk attached, the system cannot be used in 


this way. 


When the SPARCbook 2 system is started up, it attempts to find a bootable file system on the drive 
with SCSI ID3. Therefore, you should set the external boot disk to SCSI ID3. If two SCSI disks are 
to be attached externally, you should set the second disk to SCSI ID1. These ID settings are 


recommended because they mimic the settings normally used for internal drives. 


You can load the Solaris Operating System onto the external hard disk by restoring from a CD- 
ROM drive, also connected to the SCSI bus, or by restoring over Ethernet. These techniques are 
discussed in the chapter ‘BACKUP AND RESTORE’. 


SPARCbook 2 systems with internal hard disks have a factory-set security feature which keys each 
SPARCbook to its internal drives, making it difficult for internal disks to be removed from one 
machine and accessed in another, see the ‘SYSTEM SECURITY’ on page 47. This feature is not 


extended to the external disks. 
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The internal modem is not approved for connection to the telephone system in some countries. 
However, you may connect an external modem to the serial port on the rear panel and use the 


facilities provided by the SPARCbook for data and fax communications that way. 


Some of the SPARCbook tools, for example FAXtool allow you to select easily between the modem 


Details of the appropriate interface cable for connecting an external modem are 


provided in the chapter ‘TECHNICAL REFERENCE AND FURTHER READING’. 


or an external modem directly with the user interface. Other utilities use configuration files or 
device names supplied through the Solaris command interface. In the latter case, any reference to 
the device name /dev/modem should be changed to /dev/ttya to identify the serial interface 


through which an external modem connects to the SPARCbook. 


The UUCP configuration files used by both the UUCP and SLIP utilities have been structured to 
allow the selection of an internal or external modem to be made easily. The only file that requires 
change is /etc/uucp/Systems. This provides a template which should be used to select the 


modem device that will be used for communications. 


# 

# Example entries for dialup connections, using WorldPort 9600, 
# WorldPort 2496 and internal modems respectively. 

# 

# eagle any ACU W9600 <telephone number> <login> 
# eagle any ACU W2400 <telephone number> <login> 
# eagle any ACU S2400 <telephone number> <login> 
# 


The /uucp/Systems file and the UUCP facility are discussed in more detail in 


‘The Internal Modem’. 


No changes to the device or modem configuration files are necessary. 
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The SPARCbook 2 computer incorporates an internal modem. Data rates of up to 14400 baud 
(V.32bis) are achievable, with V.42 bis data compression to improve this rate by a factor of up to 4:1 
to 57600 baud. The modem interfaces to phone lines via a Data Access Arrangement (DAA) 
suitable for direct connection to phone lines in the United States. The specifications and protocols 
for the modem are provided in the chapter “Technical Reference and Further Reading’. This section 


provides information on how to connect, configure and use the modem. 
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CONNECTING THE MODEM 


To use the modem you need to plug it into the wall phone socket using the lead supplied. 


The SPARCbook is approved for connection to the US telephone system in accordance 
with FCC Part 68 rules. You are not permitted to connect the internal modem to the 
telephone system in any other country. In countries other than the USA you should 


contact your SPARCbook supplier for details of available external modems. 


The modem will normally be used in a direct calling mode. This might be used for logging into a 
remote machine, accessing a bulletin board or sending a fax. However, many UNIX based systems, 
including SPARCbook, restrict external user access to maintain security. It is often only possible to 
dial in to a special account which restricts access to other parts of the system. The mechanism for 
doing this is called UNIX to UNIX Copy or UUCP. This section also describes how to set up the 


UUCP system files for such a connection. 


A complete description of uucp and its facilities is beyond the scope of this guide. For 


NOGE 
: further information you should refer to ‘FURTHER READING’ on page 265. 
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SENDING A FAX FROM THE COMMAND LINE 


To send a fax you can use FAXtool as described in ‘FAXtool’ on page 107. If you are familiar with 
the structure and use of UNIX commands you can also send a fax directly from the command line 


prompt as follows: 


$ faxsend destination filename [filename] * 


destination is the user phone number. The phone number is specified in the 
normal way (and can include the tone dial characters * and #). Four 
special characters may be used to control the access. 
= Wait for a secondary dial tone before proceeding 
- Pause for 4 seconds 
p Use pulse dialing 
t Use tone dialing 


filename, [filename ]* 
are the files you want to send. These must be PostScript format 


files, each describing a single page. 


For example, to send a single page PostScript file called memo to a fax machine on a telephone 
number of 1 234 567 890 from an office where tone dialing is in use and 9 is the access code for an 


external line, and then switch to pulse dialing for the outside line, you would use the command: 


S$ faxsend t9=p1234567890 memo 


If you want to send an ASCH file, you will need to preprocess it using the a2ps utility to generate 
PostScript code and then fax the resulting single-page PostScript files. For example, to send a 


several page ASCII file called text to the number used above you could type the commands; 


$ a2ps text | ps2fax -os pstext 
$ faxsend 9=1234567890 pstext* 


The output of the a2ps command provides an input file, or is ‘piped’, into the ps2 fax command 
to create a file for each page, pstext.00, pstext.01, pstext.02 etc. Then the faxsend 


command is used to transmit each file matching the pstext* definition . 


The Fax utility does not spool Fax requests. If the line is unobtainable or engaged a 


message will be printed. See ‘FAXtool’ on page 107 for further information. 
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DIALING OUT TO A REMOTE SYSTEM 


You can use the phone line to dial out directly to a remote system or bulletin board. To open a 
connection to a remote system, you use the cu utility. To do this, you need to be at a command 


shell, either in your account or with an open cmdtool window. 


The cu command runs in two phases. The first phase establishes the connection and the second 
phase is interactive, and allows you to transfer files between SPARCbook machines or between the 
SPARCbook and other UNIX systems. 


To dial up a remote system type the following command: 


$cu [number] 


As for the Fax utilities the Phone number [number] is specified in the normal way (and can include 


the tone dial characters * and #). The same two special characters are used for the special functions. 


= Wait for a secondary dial tone before proceeding 


- Delay for 4 seconds 


Alternatively if you have set up a remote login (see below) you can simply specify: 


2 


6 cu systemname 


For example, to dial a phone number | 234 567 890 from an exchange where 9 is the access code to 


get an external dial tone, you would specify the following command: 


$ cu 9=1234567890 


Once you have accessed the remote system the action taken depends on the remote configuration. 
Assuming the remote system is running UNIX there are several additional command options that 


cu gives you over and above the ability to login and use the remote machine. 


! Escape into a command prompt on the local machine. 
The connection remains active. Once in the command 


prompt typing Ctrl-D will return you to the connection. 


Stake from [to] Copy a file. £rom specifies the file name on the remote 
system, to is the file name to copy to on the local 


system. If to is omitted the same file name is used. 
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Sput from [to] Put is the opposite of take. It sends the from file to the 


remote system. 
- (Period) Terminates the connection. 


In order to use system abbreviations you must edit the UUCP file called /etc/uucp/Systems. 


Before you change any UUCP related files you should be logged in as root, or have 
executed the su command, and you must change your user ID to uucp. This is 
because uucp owns all the administrative files. To do this login as root and then type: 
# su uucp 
$ 
When you are finished type 
$ exit 
# 
If you do not follow this procedure you can stop the UUCP system from working 


correctly when you have completed setting it up. 


Using the OpenWindows Text Editor or vi you can edit the Systems file to get easy access to a 


defined set of remote systems. These are three typical systems file entries: 


mars Any;15 ACU 2400 9=1234567890 in:-~in: nuucp word: secret 
mercury Any;15 ACU 2400 9=Austin123456 in:—in: user word: myown 
mypc Any;15 ACU 2400 9=homepc “ ” 


The format of the system file is as follows: 


name This is the system name. Note that this must correspond to the 


network name of the system. 


time Any; 15 is the default and allows connections at any time. It 
specifies a retry for UUCP (see below) every 15 minutes if the 
connection fails. You can also specify when to call by using Su, 
Mo, Tu etc for days of the week and by specifying a time. For 
example to call only overnight and at weekends you could use ‘Wk 
1700-0800,Sa,Su;15’ instead of ‘Any; 15’. (Wk is an 


abbreviation for Mo, Tu, We, Th, Fr) 


type should be ACU which specifies the Modem interface 
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class should be 2400 which is the default. The SPARCbook 2 modem 


will automatically adjust to lower speeds if necessary. 


phone this is the phone number of the system you are accessing. This is in 
the format above. You can also specify abbreviations from the 


Dialcodes file (see below). 


login this is used to login to the remote computer. In the example above, 
the machine mars can only be dialed into by UUCP. However, the 
machine mercury has a login that you can access. The login field 
consists of pairs of fields that are what the specified system expects 
to receive and what to send as a result. To obtain a login the 
standard sequence in:—in: is used. This is waiting for the 
login: prompt. In the example above your normal login would 
be user and then the local system looks for the password: prompt. 
Then your password is entered. If you do not want to actually login 


6699 


you can specify just the “” characters as for the mypc entry; in this 
case the line will simply connect you. If you type Enter, when you 


are connected, you should get the remote system prompt. 


You can store any number of abbreviations in the UUCP file called /etc/uucp/Dialcodes. 
Using the OpenWindows Text Editor or vi you can edit the Dialcodes file. Each line has a 
name, a corresponding number and an optional comment. Note that names must start with a lower 


or upper case letter from A-Z to avoid confusion with numbers. 
officefax 234 567 890 


homefax 1 300 300 300 
austin 1, 5:12 # austin area code 


For security reasons many UNIX systems that are accessed from the phone system 


only allow the nuucp login which is the UUCP interface. See the next section for 
information on how to set up UUCP. If you do set up a system to allow a direct login 
you should take measures to ensure a user logging in from outside cannot do damage to 


your computer installation or access sensitive data. 
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THE UUCP FACILITY 
Using UUCP you can copy files and queue transfer requests to and from a remote system. Unlike 
the previous utilities, UUCP is not permanently connected to the phone line. Instead all UUCP 
tasks and requests are queued. UUCP may be configured to periodically start up and determine if 
there are any tasks. If necessary, it will dial out to one or more remote systems and either deal with 


the outstanding requests or enquire from them if there is any new information or data for the local 


machine. This facility can be used to transfer files between machines unattended. 


The UUCP utility can be complex to set up. This section explains how to set up the 


default UUCP interface for a machine that is connected to the phone line. You should 
refer ‘FURTHER READING’ on page 265 if you want to configure UUCP in any 


other than the basic way described. 


To use UUCP you must set up a few default files as follows. Remember you must have logged in as 


root, and have changed your ID with the su command to that of uucp. 


. The Systems file 


The first file is the Systems file which was discussed in the previous section. This must contain an 
entry for each remote system that you want to communicate with. The example below shows the 


entry for a machine named mars running a public UUCP account with a password of secret. 


mars Any ACU 2400 9=1234567890 in:—in: nuucp word: secret 


As explained in the previous section you would normally only alter the system name, the phone 


number and the password to access a remote system. 


. The Poll File 
The file /etc/uucp/poll gives information for polling remote computers. 


The format of the file is the system name, followed by a TAB character followed by the hours (24 
hour clock) the machine should be called. The example below calls the machine mars every 4 


hours: 


mars 0 4 8 12 16 20 
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Setting up UUCP on the Remote Machine 


Setting up UUCP on the remote machine depends on the version of the operating system and UUCP 
being used. If the machine is not a SPARCbook you should consult the system administrator or the 
operating system documentation for the machine you wish to access. If you are using a 


SPARCbook for the remote machine you do not need to configure any files at all. 


You can call directly between two SPARCbook systems by connecting both to the phone network 
and using the cu facility, or by setting up the Systems file on the calling machine and using the 
uuto and uupick utilities described next. Before you can do this you will need to enable the 
Modem as a login port by editing the system file /etc/ttytab. In it you will see the following 


line in which you should change of f to on: 


modem “usr/etc/getty std.2400 dialup off secure 


Next you must tell the Operating System to reread the /etc/ttytab file by entering the 


following command at the Command Tool or shell prompt: 


# kill -1 1 


Using UUCP Utilities 


The UUCP facility may now be used to copy files to and from remote systems as a background 


activity. The uuto and uupick commands are used to transfer files: 


° Sending Files 


The uuto utility sends the specified files or directories to a remote user. The remote user is notified 


of the arrival of the files by mail. 


$ uuto [-m] [-p] files destination 


files This is the file or files to copy. This should just be the pathname(s) 


of the files and/or directories to copy. 


destination This is of the form system! user where system must be a 
system known in the /etc/uucp/Systems file, and user is 
the name of a user on the remote computer to whom mail will be 


sent when the file copy is complete. 


178 


THE UUCP FACILITY 


[-m] the -m is optional (do not type the brackets if you use it) and sends 


you mail when the copy has been successfully completed. 


[-P] the -p is optional. If you use it a copy of the file will be spooled for 
the delivery. If you do not the original copy will be used. 
Remember that the copy may not occur for some time depending 
on the system configuration so you should specify —p if you intend 


to change the file or delete it. 


For example to copy the files worklist and playlist from your current directory to a user 
with the account harry on the machine called mars set up in the previous example you might 


type: 

% uuto -p worklist playlist mars!harry 
° Receiving Files 
The uupick command allows a user to receive files sent by uuto. 


% uupick [-s system] 


-s the -s is optional (do not type the brackets if you use it). You can 
specify a single system to look for files from. The default is to look 


for files from any system. 


uupick will print lines for each received file or directory and will ask you what to do with them. 


Options are: 


Enter Press the Enter key to go to the next entry and take no action. 
d Delete the entry. 
m [dir] Move the file or directory into the current directory. dir is 


optional and is the name of a directory to put the data in. 


a [dir] Same as m but operates on all the files that have arrived. 
Pp Print the file on the default printer. 
q Quit. 


For example to receive the two files sent previously and place them in a directory called infiles, 


the user harry would type: 
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% uupick 

from jupiter jupiter:file worklist ? m infiles 
from jupiter jupiter:file playlist ? m infiles 
% 


ELECTRONIC MAIL 


The SPARCbook 2 system has facilities for sending and receiving Electronic mail or email. The 
user interface to the mail system is described in the sections on Mail Tool and POPtool. However, 
before these facilities can be used the email system must be configured for your own requirements. 
This section describes the email service and how to configure your SPARCbook for the sending and 


receiving of email. 


While working as part of a larger network of machines the network itself will normally provide 
email facilities. When you take the SPARCbook away from the network you can use the cu facility 


or SLIPtool to dial in to a remote system to collect your mail. 


i ae It is also possible to set up a SPARCbook as a complete stand-alone email system. In 
NOE 

_ this mode it would be essentially a stand-alone domain to the Internet and would be 
able to send and receive mail to any other Internet user directly. You will need to 
register with an Internet mail feed organization, and register as a new Internet node. 


You should refer to a UNIX administrator or the Solaris documentation outlined in 


“FURTHER READING’ on page 265 for further information. 


Setting Up Email 


By default the SPARCbook operating system is shipped ready to use an existing Ethernet based 
mail facility. If you are attaching to a network that already provides email facilities you only need to 
follow the instructions on how to connect a system up to the network. Once you have carried out 
these steps you should contact your network administrator so that your name can be added to those 


that the network knows about. A typical Internet email address for a user named user might be: 


user@eng.company.com 
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In this case the Internet services would know that the top level machine for your domain was the 
machine called eng. company.com which provides mail services in your company and is 
connected to Internet. A domain is a set of machines that are networked together. You may actually 
be on a different machine from the top level machine, but your local domain would handle the mail 
routing and delivery after arrival at the eng. company.com machine. Once you are connected 


over Ethernet to a mail server machine you should be able to send and receive electronic mail. 
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In order to access the mail facilities when you are away from the network you can use the modem 
facility inside the SPARCbook system. You will need to arrange for your mail to be forwarded to 
another machine if your SPARCbook is frequently removed from the network. The machine you 
forward the mail to must be accessible via a dial-in line so that you can dial into it and access your 


mail. You will therefore require an account on this system. 


In a small configuration this system might be the mail server itself. In a larger system configuration 


you might have the system configuration shown opposite. 


The main mail server is connected via Ethernet to your own system called jupiter. Another 
machine (in this example a SPARCbook called mercury) is also connected to the phone system 
and provides a server facility for users who want to dial in and collect their mail. Of course it would 
be possible to use the main mail server for this facility but in a large organization it may not be 
desirable for the main mail server to be accessible by any user dialing in. You need to arrange to 
have a user account on mercury and then arrange with the system administrator to have your mail 
forwarded to the new address. Note that in this case your mail address remains as before 
(user@eng.company.com) but the local route your mail takes to get to you has changed from 


user@jupiter to user@mercury. 


Reading Email 


You may access your mail using POP tool or Mail Tool, or directly from the Solaris prompt. 


POP tool allows you to read your mail from a mail sever using the Post Office Protocol (POP), (see 
‘The DeskSet Tools’ for further information). For POP tool to be used, you must make the 
connection using SLIPtool and a utility (or daemon) to process POP requests must be installed on a 


mail server. The next section describes the installation of a POP Server daemon. 


SLIP tool allows you to gain dial up access to a remote network from the 


OpenWindows environment. It provides you with remote access to network facilities, 
see ‘SLIPtool’ on page 117 for infromation about how to use SLIPtool. Setting up 


SLIP communications is discussed in ‘REMOTE NETWORK ACCESS’ on page 209, 


Alternatively, you can read your mail (but not respond to it) from Mail Tool by copying the mail file 
from the remote machine to your machine and viewing it locally. To do this, use cu to establish a 
connection to the remote machine (see ‘DIALING OUT TO A REMOTE SYSTEM’ on page 174), 
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and then copy your remote mail file to a local file so that you can examine it using the mail file 
capability of Mail Tool. For example, if your account name was user you might use the following 


command: 


% take /var/spool/mail/user newmail 


This would copy the mailfile on the remote machine to your own machine and call it newmail. 
Then using the mailfiles option in the Files menu of Mail Tool specify the file newmail and you 


will be able to read all of your mail on the local machine. 


he If you use Mail Tool you will not be able to send mail since you are not connected to 
NOTE, 


the network, unless you have an application package allowing you to do this. To send 


mail you will need to login and use the command line mail facility as outlined above. 


To read your mail from the Solaris prompt you need to dial in to the remote system (in this case 
mercury) using the cu facility. Then after logging to your user account on mercury in you should 


type mail. If you have mail a list of messages will be printed on the screen as shown below: 


Mail version SMI 4.0 Wed Oct 23 10:38:28 PDT 1991 Type ? for help 
“/usr/spool/mail/user”": 3 messages 3 new 3 unread 
>N 1 harry@mars Sat Jan 11 09:53 15/422 message from tim 
N 2 root@mercury Sat Jan 11 11:08 14/411 system administration 
N 3 peter@jupiter Sat Jan 11 11:09 18/423 your meeting 
& 


The > symbol refers to the current message. The N means that the message is new. Other types are o 
(old messages), r (read messages) and u (unread messages). Typing a ? will give a help summary 


of the available commands. Some of these are summarized below. 


d [dist] delete specified messages 
£ [Lust] print the header summary again for the specified messages 
m [user] send some mail to user — you will be prompted for a Subject. Enter 


the Subject and type Enter. You can then type your message. When 


you have finished type Ctrl-D to return to the mail prompt (the 


*&’). 

re (Tasty Reply to the current or a list of messages. The reply will go only to 
the sender of each message. Again, type in your message and 
Ctrl-D to finish. 

q Quit 
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List can be a message number or numbers separated by space characters, or can be the name of a 


user. 


Setting Up a POP Server 


A POP daemon suitable for installation on a SPARCbook or a SPARCstation running SunOS 4.1.x 
is supplied on the distribution CD in the directory OS/usr/etc. This executable file is called 
in.popd. The source for the POP daemon is also supplied on the CD and may be found in the 
/UNSUPPORTED/popd directory. 


The source for the POP daemon may be compiled to run on a variety of UNIX systems, 


although the file Makefile may need to be modified to suit. Instructions are given 
within that file describing the changes that should be made. Copy the source directory 
to the mail server and when Makefile has been modified run the command make to 


create the POP daemon in. popd. 


The POP daemon is installed on the mail server by copying it to the file /usr/etc/in.popd. 
The mail server must then be told about the new daemon. This is done by adding a line to the file 


/etc/services if it is not already present: 


# 

# Post Office Protocol Version 3 
# 

pop-3 110/tcp pop3 pop 


Then the following line must be added to the file /etc/inetd.conf: 


# 

# pop-3 is the Post Office Protocol, used to move mail around. 
# 

pop-3 stream tcp nowait root /usr/etc/in.popd in.popd 


After the mail server has been rebooted POPtool may be used to retrieve mail on demand whenever 
the SPARCbook is connected to the network. The SPARCbook is configured by default to allow 


POPtool to operate correctly but if the SPARCbook is to be used as a POPtool mail server then the 


procedure given above should be followed. 
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USING THE NETWORK 
INTERFACE 


This section explains how to connect SPARCbook 2 to an existing Ethernet network and how to 
create a network of SPARCbook machines. First the physical connection is explained, and then the 
procedures required to connect the SPARCbook to an existing network are described. Finally the 


procedures required for setting up a simple network of SPARCbook machines are explained. 
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NETWORKING TERMINOLOGY 


The Network Interface uses various industry standards for both the hardware and software 


connection. Some of the terms used in the rest of this section are explained below: 


ADDRESS 


CLIENT 


DOMAIN 


INTERNET 


NFS 


NIS 


Every machine on a network has its own Ethernet address. This is a 
unique identifier for each machine. The physical address of any 
machine is assigned by the manufacturer and has a manufacturer’s 
part and a machine address. However, the network address you will 
most often use is the logical address which is made up of the 
Internet Protocol (IP) address and a unique number assigned to 
each machine on the local network. Each system address has a 


corresponding system name. 


A network client machine is a system that may use the services 
provided by a master server machine for disk storage space, printer 


access or some other network-wide service. 


Each network of machines can be assigned a unique name. The 


name assigned to a group of machines on a site is called a domain. 


Internet is a wide area network spanning worldwide locations. 
Many UNIX based systems with Ethernet Local Area Networks are 


part of, or have access to, the Internet network. 


The Network File System, or NFS, is part of the SUN suite of Open 
Network Computing (ONC) protocols. NFS allows you to use 
directories of files on a remote machine as if they were actually on 
your own systems. Unlike the AT&T Remote File System (RFS) 
which only provides facilities for UNIX based machines, NFS can 
be used to connect to different operating systems such as DOS, 
using PC-NFS. 


Network Information Service. Previously known as Sun Yellow 
Pages®, the NIS provides a service whereby systems on a network 
can find out other systems’ names and Ethernet addresses from the 


NIS master. 
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SERVER A machine that provides services to other machines on the network 
is called a server. The server can provide services varying from 
updating all machines on the network as new machines are added, 


to providing network wide disk, backup, or printing services. 


TCP/IP TCPIIP is a family of protocols that determine how data is 


transferred across a network. 


TRANSCEIVER The transceiver is a physical unit that interfaces the SPARCbook 
Ethernet connector to an actual network medium. Depending on the 
transceiver the network may be either thick wire, thin wire or a 


twisted pair type connection. 


Solaris 1.0.1 contains extensive support for network communications and 


configuration facilities. Solaris 1.0.1 supports TCP/IP, RFS, NFS, automounting, and 
the NIS name serving facilities. This User Guide provides information on how to 
connect as a client to an existing NIS based network, and how to create a simple 
network of SPARCbooks. However, the system administration of large networks is 
beyond the scope of this guide and you are strongly recommended to refer to the 
documentation outlined in ‘FURTHER READING’ on page 265 for further 
information. Note also that only NFS is bundled with the SPARCbook Operating 


System. The RFS facilities are available on the supplied CD. 


CONNECTING TO THE NETWORK 


There are several different types of physical media to which the SPARCbook Ethernet interface can 
be connected. These include the familiar Ethernet cable, the lower cost Cheapernet coaxial cable 
and more recent twisted pair physical connections. Before connecting to a network you need to 


know which media you will be using. | 


You will need a transceiver interface which connects the SPARCbook to the network. There are 
many different types of transceiver interface available from third party vendors and the 
SPARCbook provides an industry standard 15 way female D type connector with slidelock to 


interface to the transceiver cable or directly to a miniature transceiver. 
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Ethernet 


To connect the system to Ethernet you will need to connect the transceiver or transceiver cable to 
the back of the SPARCbook. The 15 Pin D type connector has a slidelock to retain the transceiver 
cable which can be quite heavy for a traditional Ethernet. If using cable, the other end of the 
Transceiver cable is connected to the transceiver which provides the actual network interface. The 
method of connection between the transceiver and the network is dependent on the transceiver and 


the network type. 


NETWORK ADDRESS 


If you are interfacing to an existing network, you will need to obtain or determine a new unique 
Internet Protocol (IP) address for your machine. An address uniquely identifies your machine on the 
network. Addresses are normally allocated by a single person for the network — the network 
administrator. If you are setting up a new network, you need to determine the network addresses 


you will use. 


Worldwide Internet addresses are allocated and administered by an organization 
known as the DDN/ARPANET Network Information Center (NIC). If you intend to 
access Internet you must obtain an Internet address from the NIC. Even if you do not it 
is strongly recommended that you obtain a unique network address from the NIC to 


avoid later difficulties. 


All IP addresses consist of 32 bits, normally written as four decimal numbers each from 0-255, 
separated by periods. For example, a typical IP address is 192.9. 200.98. There are three types of 


network class assigned by the NIC: 
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Class A Only the largest networks are assigned Class A addresses which 
have the first number in the address as 0-127. Each Class A 


network has over 16 million available addresses. 


Class B Large organizations and groups of subnetworks sometimes have a 
Class B address. The first number is 128-191, the second number is 
also assigned by the NIC, and over 65000 addresses are available 


for each Class B network. 


Class C The majority of networks are classified as Class C networks. These 
use a first number of 192-223, with the second two numbers also 


allocated by the NIC, and each has up to 254 hosts available. 


As part of the setup procedure the first time you use a SPARCbook on a network you will need to 
enter an Internet address. You are strongly recommended to obtain your own Class C address from 


the NIC. For further information contact the NIC at the following address: 


Electronic mail: HOSTMASTER@NIC.DDN.MIL 
Telephone: (800) 235-3155 
Postal mail: SRI International 
DDN Network Information Center 
333 Ravenswood Avenue 
EJ217 
Menlo Park, CA 94025 


INTERFACING TO AN EXISTING NETWORK 


Before you can use a network, you must first tell your system of the existence of all other machines 
on the network, and alert those machines that a new system has been added. There are two ways of 
doing this that will be discussed here. The first is to update an NIS server machine with details of 
the new network configuration and allow that information to be propagated automatically onto the 
other network machines; and the second is to edit the relevant configuration files on each of the 


machines that require to communicate with each other. 
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Initial System Configuration 


If you have configured your SPARCbook as a networked machine (see ‘Configuring SPARCbook 
for a Network’ on page 42) you can proceed to the next section. If you did not, or wish to change 
the configuration, you will need to reinitialize your system with the relevant network parameters. 
To do this you will need to exit OpenWindows, if it is running, login as the superuser using the 


root account, and run the sys-config program by typing: 


login: root 

# /usr/etc/install/sys-config 
The initial system setup menus are displayed. Refer to the ‘Basic System Configuration’ section at 
the start of this guide which guides you through the set-up procedure. You will need to enter the 
Internet address and whether you want to run NIS or not. You will then need to restart the Operating 
System for the new information to take effect. This will happen automatically if you answer ‘yes’ to 


the system reboot question. 


After you have configured the system as a networking node you can proceed with configuring the 


machine onto a network with or without NIS. 


NOTE The SPARCbook will automatically detect whether it is on the network when it powers 
i up and during use. The removal of the network connection is regarded as a normal 
event on a portable, and if you configure the system for networking it will operate 
correctly on or off the network. See the section ‘NETWORKS AND PORTABLE 


MACHINES’ on page 212 for a further discussion. 


Configuring for a Network With NIS 


If the network you are connecting to is running the Network Information Service (NIS) you will 
only need to add your machine’s details to the NIS master server machine. This information is used 
to update all other machines on the network automatically with the new machine name and address. 
Therefore, as an NIS client you should only need to configure the system for NIS operation to gain 
access to all of the network facilities. You should, however, ensure that details of your machine 
have been added to the network NIS server. Information on setting up a SPARCbook as a NIS 


server or as a slave NIS server is provided in the next section. 
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You should not configure your SPARCbook for NIS operation unless it going to be 


permanently connected to the network. If you login on a machine which is configured 


O=<Q 


for NIS operation and removed from the network, it will attempt to contact the NIS 
server and may hang. This situation can be remedied by reconnecting your 


SPARCbook to the network and logging in again as normal. 


You may set up hosts. equiv and. rhosts files as described in the next section if you wish. 


If you have difficulty in communicating with other machines on the NIS network you will need to 
seek advice from your network administrator or refer to the optional complete documentation 


package for the Solaris 1.0.1 Operating System. 


Configuring For a Network Without NIS 


If the network you are connecting to is not running NIS you first need to edit a single configuration 
file on each machine to get the SPARCbook installed on a network initially. The file /etc/hosts 
provides a directory of all the systems on the network that you are able to communicate with, and 


provides information on the names and addresses of each machine. 


° Edit the Local Hosts File 


To edit the /etc/hosts file you must be logged in as root. You can edit the file from the 
OpenWindows environment using the Text Editor, or you can use the vi editor from the command 


shell prompt. 


By default the /etc/hosts file contains an entry for the local machine called localhost. In 
addition, the startup procedure you went through when you first started up the SPARCbook asked 
you to assign a unique name to the system which was placed into the /etc/hosts file. The 
example shows the default file for a machine named jupiter with an Internet address of 
192.9.200.99. 
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# 

# Sun Host Database 

# 

# If the NIS is running, this file is only consulted when booting 
# 

127 :.0' Os dL localhost 

# 

192.9.200.99 jupiter loghost 


This file needs an additional line for each machine that you need to communicate with on the 


network. Each line contains the following information: 


ip-number hostname[# comments] 


The example local network address is by default 192.9.200. This is provided as an example only. It 
is recommended for anything other than small or test local networks that you obtain IP addresses 
from the NIC as outlined above. For example, the following might be a typical file for a network of 


6 machines if you were allocated a Class C network address of 192.9.200: 


# 

# Sun Host Database 

# 

# If the NIS is running, this file is only consulted when booting 
# 


127 010 0.6.2 localhost 

# 

192.9.200.99 jupiter loghost# my own SPARCbook 
# 

192'.9 210051 saturn # reception 
192).:9...200 2 mercury # stores 

192) s'9 3200 <3 solar # server machine 

# 

# The lab Sun workstations 

# 

192.9.200.20 sundevl # devt Sun Workstation 
192.9.200.21 sundev2 # backup devt Sun 


Once all the machine names and addresses have been added you should save the file. 
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° Edit the Remote Hosts Files 


In order for each machine to recognize your own system you need to add your system name and 
address to each of the machines you want to be able to communicate with. To do this edit the 
/etc/hosts file on each machine adding a line with your own system name and the IP address. 


For the previous example you would add the following line: 
192..9..200.99 jupiter # the new SPARCbook 
° Set up the Default Router 


If your network is local and you are not connecting to any other networks you do not need to do 
this. On a larger network one or more of the machines will be a router. A router is a server machine 
that communicates with other networks. Requests for access to other networks are sent through 


routers. To set up a router you need to edit the file /etc/defaultrouter. 


First set up the /etc/defaultrouter file by using the OpenWindows Text Editor, or the vi 
editor from a Command Tool. You will need to create this file and it should contain the name of the 
router machine. Then edit the file /etc/rce. local and remove the ‘#’ symbols from the 


following lines: 


#if [ -z “Sdefroute” ]; then 


# if [ -f£ /usr/etc/in.routed ]; then 
# in.routed; echo ‘running routing daemon.’ 
# £5. 
#EL 
° Set up Equivalent Hosts Files 


This step is optional. By default all machines listed in the /etc/hosts file have access to your 
machine. The hosts. equiv file is a list of machines from which users may login (using 
rlogin) and/or use the printing services on your machine without a password (assuming that there 
are user accounts for those users on the local machine). For example the following hosts .equiv 
file would allow anyone on the machines named mars and mercury to login to your own 


machine without a password. 


mars 
mercury 


195 


CREATING A NEW NETWORK 


The file is simply a list of machine names — one per line. You can edit it using the OpenWindows 
text editor or the vi screen editor. The default is a file with a single line consisting of the + 


character which is equivalent to allowing all known machines access. 


° Set up the User Hosts File 


The .rhosts file is optional. You may set up a .rhosts file in any user’s home directory. The 
format of . rhosts is the same as that of hosts.equiv but the file applies to the particular user. Thus 
if the previous example was used for a . rhosts file the user could log in from mars or 

mercury without using a password. In addition, you may specify other users on a remote machine 
who can log in without using your password. For example, your own . rhosts file might look like 


this: 


mars 
mercury 
mars harry 


This means that you can log in to the local machine from mars andmercury as yourself, and that 


the user called harry on mars can also login to the local machine as you. 


The hosts.equiv and .rhosts files allow a measure of network security to be maintained 
while making it easy for users to access the resources of remote machines. Remember that since 
only you can write your own files, a remote user must have access to your account before being able 


to write files or even copy files into your own directory. 


If you have followed the above procedures you should now be able to login and communicate with 


other machines on the network from your normal login account. 


For an overview of the available network facilities see ‘Network Facilities’. 


CREATING A NEW NETWORK 


If you are creating a new network of machines you can employ the basic networking interfaces or 
you can implement the NIS schemes. A detailed description of setting up large or complex 
networks is beyond the scope of this User Guide and you should refer to ‘FURTHER READING’ 


on page 265 for further information. However, to set up a simple network you can simply follow 
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the procedures outlined in Configuring a Network Without NIS. If you follow these instructions for 
each system on the network you can immediately start to use the main network facilities provided 


in the Solaris 1.0.1 Operating System which are summarized in the next section. 


Alternatively you can configure one of the machines on the network to be the NIS server and 
configure the other machines as clients. The following section explains how to set up a single NIS 
server on a single network. The server is assumed to be a Sun Workstation running SunOS 4.1.x or 
a SPARCbook running Solaris 1.0.1. 


If you are setting up a new network you need to choose between setting up a network 


based on NIS and one without NIS. The latter is easier for a network with only a small 
number of machines, but on a large network with many machines and different users 


NIS is an fundamental! tool for managing the network administration requirements. 


Setting Up a Simple NIS Server 


. Set up the /etc/hosts file as described in ‘Configuring a Network without NIS’ for 


all the machines in the network. 


° Ensure no network services are being used and login as the superuser: 


login: root 
# 


° Initialize the NIS database files: 

# cd /var/yp 

# /usr/etc/yp/ypinit -m initialize the NIS server 
Answer no to the question on non-fatal errors. The system will then ask for the names of other NIS 
servers. Since you are setting up for only a single server you should type Ctrl-D to the question. 
The ypinit program will then initialize the system databases for NIS service. After this has 
completed you can start the NIS server itself. The next time you boot the system this will all happen 


automatically. 
# ypserv start the NIS server 


Next edit the file /etc/rc. local using the OpenWindows Text Editor, or a screen editor such 


as vi. Look for the lines shown below: 
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Master NIS server runs the XFR daemon 


So SO 


ypxfrd echo -n ' ypxfrd’ 


Delete the # comment symbo] at the start of the ypxfrd line which will then be as shown below, 


and then save the file. 


# 
# Master NIS server runs the XFR daemon 
# 


ypxfrd echo -n ' ypxfrd’ 
In future this will start up automatically if the system is rebooted. For now, however, you must start 
it manually by typing: 
# ypxfrd start the XFR daemon 


Finally, you need to configure the client machines to run NIS so that they consult the server for the 
host and other NIS information. See ‘Initial System Configuration’ and ‘Configuring for a Network 


with NIS’ above for further information. 


For NIS to operate you must set up the server first, and then the client machines. If 


client machines are already on the network you will need to restart them using the 


reboot command executed as superuser before the NIS service will operate. 


If you add a host to the network at a later date you only have to edit the /etc/hosts file on the 
NIS server and remake the NIS database by doing the following on the NIS server. The new 


machine will then be able to access all the existing networked machines with no further changes. 


# cd /var/yp 
# make re-make the NIS database maps 


This Guide can only describe the simplest NIS configuration. For information on 


setting up NIS passwords, automounters, user and group databases, C2 level secure 
networks, master and slave servers, and other more advanced network administration 
topics you will need to refer to the documentation outlined in “FURTHER READING’ 


on page 265. 
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Setting Up a Slave NIS Server 


° Set up the /etc/hosts file for your machine as described in ‘Configuring a Network 
without NIS’. 


. Ensure no network services are being used and login as the superuser: 


login: root 
# 


. Set up the domain name, for example in a domain called ‘sparc’: 


# echo ‘sparc’ > /etc/defaultdomain 
# domainname sparc 


. Initialize the slave NIS database files by copying the NIS database file from the master 


NIS server, for example for a master server called ‘neptune’: 


# ypbind 

# /usr/etc/yp/ypinnit -s neptune 
Follow the installation procedure by answering the questions as they are put. When the procedure is 
complete, restart the system to ensure that your SPARCbook is using its own copy of the NIS 
database. You may check this by using the ypwhich command which will print the name of the 


NIS server. This should be the name of your machine. 


NETWORK FACILITIES 


This is a brief guide to the network facilities available on the SPARCbook system. This covers 
copying files, logging in to a remote system, and executing programs on a remote system. The 


following section describes how to set up a simple network-wide distributed file system. 


There are many other network capabilities provided in the Solaris Operating System. If 


you are not familiar with UNIX networking you should refer to ‘FURTHER 


READING’ on page 265 for further information. 
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Copying Files 


The rcp command is used to copy files between machines. You may do this from the File menu of 


the File Manager in OpenWindows. 


Choose the Remote Copy option by moving the pointer to the Files button, pressing Menu and 
holding it down while you move the pointer to the Remote Copy option. Releasing Menu will cause 
a pop-up window to be displayed. You should not specify the name of your own machine in the 
Source Machine or Destination Machine field. The path can be a file name or a directory name. The 
example below copies a file called info from the local machine to the /tmp directory on a 


machine called mars. 


Source Machine: 
Source Path: info ea 
Destination Machine: Harps 


Destination Path: “tmp, | 


eae es 


Alternatively, from the Solaris command prompt you can use rcp as follows: 


%$ rep [-r] [fromsys:]fromfile [tosys:]tofile 


-r is to copy a directory as opposed to a file. 

fromsys: is the name of the remote system you are copying from. It is not 
used if you are copying from your own machine. 

tosys: is the name of the remote system you are copying to. It is not used 


if you are copying to your own machine. 
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The same example as before using the rcp command would be: 


% rep info mars:/tmp/info 


Remote Login 


You may login over the network as a user on another machine. Depending on how you have set up 
the network, you may need to supply a password to login to a different machine. In addition, you 
will not be able to login to a remote machine unless you have a user account on that machine or the 


NIS service is running and knows your password. 
The format of the remote login command is as follows: 


% rlogin [-l user] machine 


-l user is the account name to use for the remote machine. The default is 


your own account name, when you can omit the -I option. 


If the remote machine is not running (for example it is switched off) nothing will happen when you 
attempt to login (although after several minutes the attempt to connect will time out). To stop the 

login attempt press the interrupt key sequence (Ctrl-C). To logout you may either logout as normal 
using the Ctrl-D key sequence or you can break the network connection by typing the tilde symbol 


and then a period (~.). 


% rlogin mars 
Last login: Sun Sep 23 06:00:05 from jupiter 


mars% ~. 
Closed connection 
% 


Remote Program Execution 


If you want to execute a command on a remote machine rather than actually login, you can execute 


it using the remote shell or rsh utility. The command syntax is as follows: 


$ rsh sysname command 


sysname is the name of the remote system to execute the command on 


command is the command to execute 


For example to list the files in /home on the machine called mars you would type the following: 
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% rsh mars Ils /home 
peter paul user demo file/directory names 


Checking a Remote System 


To see if another machine is operating on the network you can use the ping command which sends 


a low level protocol request to the specified machine and waits for a response. 


$ /usr/etc/ping mars 
mars is alive 


or 


$ /usr/etc/ping mercury 
no answer from mercury 


The command syntax is: 


$ ping name [t] 


name is the name of the remote system 
t is optional time in seconds to wait before giving up. The default is 


20 seconds. 


NETWORK PROBLEMS 


Most network problems are either related to the initial hostname set up, or are to do with the 

systems files configuration. Some of the more common errors give appropriate error messages 

when you try and execute commands. A few of the more common errors are described below. 
Message: Permission denied 


This message is because you do not have permission to carry out the requested operation. This 


could be for one of the following reasons: 
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¢ You do not have an account on the remote system. 

¢« You have not set up a .rhosts file. 
If you do not have a .rhosts file set up you may be able to login to the remote 
machine but not use rsh or rcp. 

¢ The directory you are trying to read or write has been set up so you have no 


permission to read or write it. 


See ‘System Setup’ and ‘Configuring the Network’ for more information on the file configuration 


and setting up accounts. 


Message: [hostname]: unknown host 


This message is because your system does not recognize the host name you have used. Check the 


following: 


¢ If you are not running NIS check the remote system’s name is in the /etc/hosts 
file 

¢ If you are not running NIS check your system’s name is in the remote system’s 
/etc/hosts file 

¢ If you are running NIS check that the NIS server’s /etc/hosts file has your 
system’s name included and that the NIS database has been updated (see ‘Setting up 


a Simple NIS Server’). 


Message: Login incorrect 


This message is typically caused by an rcp or rsh operation attempting to login to a remote 
system on which you do not have an account. Look at the same things as for the Permission 


Denied message above. 


SETTING UP A DISTRIBUTED FILE SYSTEM 


The SPARCbook implementation of Solaris 1.0.1 provides facilities to run both the Sun Network 

File System (NFS) and the AT&T Remote File System (RFS). Both are examples of distributed file 
systems. However, only the NFS file system is supported in the bundled SPARCbook distribution. 
The RFS package is available on the system CD supplied with the machine. Refer to ‘Customizing 
the Solaris Operating System’ for more information. Use of a distributed file system allows you to 


set up a network with users able to access files on remote machines as if they were their own. For 
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example a file server can be configured with a large disk drive to store shared files such as manual 
pages, which are then accessible to all users. This section explains how to set up a distributed file 
system based on NFS. For more detailed information you will need to refer tos FURTHER 
READING’ on page 265. 


You will need to be logged in as root, or to be in a Command Tool and have executed the su 
command, to carry out the following procedures. Remember to logout or type Ctrl-D when you 


have finished revert to your normal privileges. 


Sharing a Directory 


You can make one or more of your own directories available to the network. Other users on the 
network are then able to access these directories, and any files or subdirectories they contain. To 
make your whole system available you can specify the root directory, but more normally you will 


only make a file system or a specific directory of files available. 


You will need to login as root to perform the following operation from an OpenWindows command 


tool shell prompt or from the login prompt. 


Using the OpenWindows Text Editor, or a UNIX editor such as vi from a command tool, edit the 
file /etc/exports. This file will not already exist if you have not yet used this facility on your 
SPARCbook 2. This file consists of a set of lines each of the following format. In addition any line 


starting with a # symbol is taken as a comment and has no effect. 


directory [-option[,option]...] 


directory is the name of the directory you wish to share or export. 


option is typically one or more of the following: 
ro export the directory read-only (the default is 
read/write) 
rw=host[:host]... export the directory read-only except to the 


specified host(s). 
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root=host[:host]... allow root (superuser) access to the specified 
hosts(s). The default is not to allow superuser 


access privileges. 


For example, the following lines would allow other network users to be able to read or write any of 
the files in the /usr directory, and to'read but not write the files in the /opt /editors directory 


on your machine. 


# /etc/exports file 
# directories to share 


/usr # read/write access 
/opt/editors -ro # read only access 


To allow the directory to be exported you can either restart the operating system by logging in as 
the superuser and typing reboot, or you can immediately allow access by running the following 
commands. Note that once the /etc/exports file exists the specified directories will be 
exported automatically whenever the operating system is restarted (as opposed to saved and 


resumed) from then on. The following commands can be used to export a directory without needing 


to reboot: 
# nfsd 4 & start four NFS daemons 
# exportfs -a export the directories specified 
# rpe.mountd -n start the mount daemon 


If you are adding directories to an existing /etc/exports file the NFS daemons will already be 
running and you only need enter the exportfs command. If you type exportfs on its own with 
no arguments the system will report a list of shared directories. You can also unexport a shared 


directory at any time by using the exportfs -u command as the examples below show: 


# exportfs -u /usr deny NFS access to /usr 
# exportfs -ua deny NFS access to all directories 


NFS shares directories on a file system basis. Thus, if you have a dual disk 


SPARCbook and you wanted to export all of your files you would need to export the 
root directory (/) and any mounted file system directories. To get a list of the mounted 


file system directories use the mount command. 
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You should be careful when you shut down the machine, or when you use the 


exportfs -u command since the resources on your machine will then become 


unavailable to other users, even if they are in the process of actually using them. 


Using Shared Directories 


To access a directory that has been made available for sharing on the network you use the mount 
command. This allows you to mount both local file systems and remote directories, and to then 


access them from within your normal directory structure. 


You will need to login as root or be superuser to perform the following operation from an 


OpenWindows Command Tool shell prompt or from the login shell prompt. 


# mount [-r] [-o options] remname:pathname mtpoint 


-r specifies to mount read only (default is read/write) 
options is one or more of following, comma separated 
soft return an error if NFS request is not accomplished and 


stop trying (default is hard) 


hard try repeatedly until maximum retries is reached 
retry=n set maximum retries to n (default is 10000) 
remname is the name of the remote system 
pathname is the directory name on the remote system 
mtpoint is the directory name on the local system to place the directory 


For example, assume you wanted to mount the editors and the usr directories from the 
previous examples on a different machine. Suppose that you want to use a new directory called 


/usr/files and that the machine with the actual directories on is called pluto 


# mkdir /usr/files 

# mkdir /usr/files/plutos_usr 

# mkdir /usr/files/editors 
These steps are only needed if new directories are required. You can mount exported directories 
onto existing directories if you wish but you will not be able to access the existing directories’ 
contents while the remote directory is mounted on them. The command mkdir makes a new 
directory and is the equivalent of making a new folder from the File Manager in the OpenWindows 


environment. 
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Next mount the directories: 


# mount pluto:/usr /usr/files/plutos_usr 
# mount -r pluto:/opt/editors /usr/files/editors 


Note that for the second command you must specify read-only since the directory was only made 


available read-only. The directory structure of the machine you are using will be changed as shown. 


lutos_usr editors 
Pp 


You may also specify remote directories to be mounted automatically when you start up the 
Operating System or after a reboot (but not after a save and resume). To do this you need to edit the 
/etc/fstab file. The fstab file consists a set of lines for each directory and file system to be 


mounted. The default SPARCbook fstab file for a single disk system is: 
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/dev/id0a / 4.2 rw i a 
/dev/£d0 /pcfs pefs rw,noauto 0 0 
/dev/£d0 /floppy 4.2 rw,noauto 0 0 
swap /tmp tmp rw 0 0 


Each line has 6 fields separated by Space or Tab characters. These fields are: 


Device to mount: This is the device name for a local file system or the 
remname: pathname as defined above for a remote 
directory. 

Mount point This is the directory where the file system or remote 
directory is to be mounted. 

FS type This is the type of file system which will normally be 
4.2, for a local file system, or nfs, for a remote 
mounted directory. 

Options normally ro for read only, or rw for read/write. The 
other NFS options specified above may also be used. 
The noauto field means the directory will not be 


mounted automatically at operating system startup. 


Freq Number of days between dumps for the automated 
backup facilities documented in the full operating 
system documentation. Normally set to | for local file 
systems and 0 for remote mounted directories. 

Fsck Pass Normally 1 for the root file system, 2 for all other local 


file systems, and 0 for remotely mounted directories. 


For example, to automatically mount the directories specified before you would edit the 


/etc/fstab file by adding the following two lines: 


pluto:/usr /usr/files/pluto_usr nfs rw 0 0 
pluto:/export/editors /usr/files/editors nfs ro 0 0 
As superuser, you may unmount a directory at any time by using the umount command with the 
mount point directory as an argument. For example, to unmount the two directories used previously 


you would type: 


# umount /usr/files/pluto_usr 
# umount /usr/files/editors 
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If you get a message saying [name]: Device busy, it is because the machine is still using 
files in that directory. This may be because an application is using files in that directory, or simply 
that your current directory is in the mounted tree. You will need to quit any applications that are 


using the remote resources, and/or change directory to a local directory before trying again. 


REMOTE NETWORK ACCESS 


The SPARCbook 2 system provides a facility to allow you to communicate with a remote network 
via the modem or a direct serial connection. This facility is called Serial Line IP (SLIP) and is used 
to transfer Internet packets between the SPARCbook and remote hosts. Once a SLIP connection has 
been established any of the usual networking commands may be used to communicate with remote 


hosts. 


The Deskset interface to the remote networking facility is SLIP tool, see “The DeskSet Tools’, 
which allows the remote host to be selected and the SLIP configuration to be altered before 
establishing a connection. This section describes the configuration that is needed to allow SLIPtool 


to operate correctly and the commands that may be used to access SLIP from the command line. 


Setting up a SLIP Host 


Before you can dial into the network, the Tadpole SLIP Module should be installed on the machine 
that is going to provide the gateway between the network and the serial line. This may be either a 
second SPARCbook or a SPARCstation. The SPARCbook will already have the SLIP driver 


installed. 


The SLIP Module is in the form of a kernel loadable module for SunOS 4.1.2 and Solaris 1.0.1 
Operating Systems. When the module is loaded, two SLIP network interfaces are available with 
which to form the SLIP connections. These interfaces are allocated the names s10 and s11 and 


their current status may be seen using the ifconfig command: 


$ ifconfig -a 


Having copied the /usr/s1lip tree to your Sun, you need to add the following lines to the 


/etc/rc.local file. 
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# 
Module=’arch -k’ 
if [ -f£ /usr/slip/modules/slipmod-$MODULE.o] 
then 
modload /usr/slip/modules/slipmod-S$MODULE.o >/dev/null 2>&1 
fi. 


You should then copy the /etc/slip.conf file as follows. Amodem should be connected to the 
gateway system and a login process provided for the line. On the SPARCbook the file 
/etc/ttytab should be edited and the line for the modem changed to: 


modem “/usr/etc/getty std.2400” dialup on secure 


When configuring a SPARCstation the file /etc/slip.conf should be copied from a 
SPARCbook. Below is an example configuration file from a SLIP server. It is not necessary to have 
a line in this file for every SPARCbook that will be dialing in as the configuration as 
DefaultName will be used whenever a specific entry is not available. The example given below 


will adapt to dialup SPARCbooks whether or not they are using SLIP compression. 


# 

# /etc/slip.conf - configuration file for SLIP interfaces 

# 

# Each entry consists of an network address followed by a number of 
# configuration keywords. The possible keywords are: 

# 

# compress - packet compression will be used 

# auto - automatically use compression if remote system uses it 
# icmp - allow ICMP packets to pass through the interface 

# private -mark this interface as private (see ifconfig manual page) 
# proxy - use proxy-arp if it seems appropriate 

# 


# An option is disabled by preceding the keyword witha ‘-’ (e.g. -icmp). 
# By default a SLIP interface will be configured to perform no 
# compression, no auto-enable of compression and ICMP enabled. 
# | 
DefaultName -compress auto icmp -private | 


Reboot the host so that the SLIP modules are loaded 


Setting Up the SPARCbook 


Before SLIPtool can be used to establish a SLIP connection to the SLIP server it is necessary to 
write a script that will allow the login procedure on the remote machine to be performed. SLIPtool 


uses the UUCP mechanisms to define the remote systems that may be accessed. The section 
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‘Dialing Out to a Remote System’ should be consulted to see how system abbreviations are defined. 
It is these abbreviations that will be used by SLIPtool to form the list of available SLIP hosts. Note 


that the login dialog must be specified for systems that will be used for SLIP communication. 


If the SPARCbook will contact machines on the remote network other than the SLIP server, the 
routing daemon should be started on both the SPARCbook and the server as described in the section 


‘Configuring for a Network without NIS’. 


SLIP Commands 


SLIP communication may be initiated from the command line, although SLIPtool should be used in 


preference as it handles the manipulation of configuration files automatically. 


If SLIPtool has already been used to successfully establish SLIP communication to a remote host 
then the connection procedure is straightforward. Using the cu command with the following 


arguments should dial the remote host and establish the SLIP link: 


# cu -S local -D target system 


where: 
local is the network name of the SPARCbook 
target is the network name of the remote host 
system is the system name as defined in the file /etc/uucp/Systems. 


If SLIPtool has not been used before, then the file /etc/slip.conf should be edited to insert a 
configuration record for the target system. If this is not done then the configuration specified by the 
DefaultName entry in that file will be used. Configuration entries allow the compression, 
automatic compression, ICMP and private options provided by SLIPtool to be managed on a host 
by host basis. Comments are provided within the file to explain the format for new entries. When 
the configuration record has been entered the connection may be made using cu as described 


above. 


In order to disconnect a SLIP link it is first necessary to determine which SLIP interface has been 
allocated to the link. This may be done using the ifconfig -a command to list the interfaces 
and the hosts to which they are connected. If only one link has been established, the SLIP interface 
allocated will always be s10. When the correct interface has been found the link may be broken 


with the command: 
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where: 


# sldetach <interface> 


interface is either sL0O or s11 (do not enter the brackets). The remote host 


will automatically be released for the next dialup user. 


NETWORKS AND PORTABLE MACHINES 


Since SPARCbook 2 is a true notebook sized portable workstation it may be frequently connected 


and disconnected from the network. This does not pose any significant problems as long as you are 


aware of the implications of your actions. 


In normal use, when connected to the network, you will have access to all of the network facilities. 


This can be very useful in providing access to large file servers, printers and other resources 


available on the network. However, when you are disconnected from the network you will only 


have the facilities on your own SPARCbook machine. The Save and Resume feature may be used to 


switch off your SPARCbook before you disconnect it from the network and take it away. When you 


return and reconnect to the network the Resume facility will take you back to where you were. 


However, you need to be aware of several possible implications of frequent connection and 


reconnection to a distributed file system. 


USING REMOTE RESOURCES 

You should not shut the SPARCbook 2 down or perform a Save when you have files 
open in remote directories. If you do, you may lose any changes you have made and 
you may have problems when you restart the machine (the files you are using may 
have changed, or may no longer be present). In addition, if the remote server is shut 
down while you are away, the knowledge of your connection will be lost and you will 
not be able to access the file when you Resume. It is recommended that you unmount 


any remote filesystems before Saving. 


PRINTING 
It is not recommended that you try and print files to a remote printer when you are not 
connected to the network. However, if you do try and print a file to a remote printer 


while you are not attached to the network the print file will be spooled. Errors will be 
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displayed on the Print Tool or the Console and the printer processes may stop. Refer 


to ‘Printer Problems’ on page 149 if this happens. 


MAIL 

If you have set up a remote system for mail services the SPARCbook will only access 
the remote system when it is connected to the network. Received mail can be 
collected when the SPARCbook is next connected. Mail to be transmitted via the 
network should only be sent when you are attached to the network physically, or by 
logging into a remote machine using the internal modem connection. See 
‘ELECTRONIC MAIL’ on page 180 for further information. 


SLIP 

When connected to a remote network via a SLIP connection, most of the commands 
that may be used when attached to the local network directly may also be used 
remotely. This means that once SLIPtool has been used to connect to the remote 
network, the network printer may be used and mail may be sent from the 
SPARCbook. Care should be taken when disconnecting the SLIP interface however, 
as SLIP data transfers are slow and information will be lost if the interface is 


detached while a transfer is in progress. 


Although network facilities may be accessed remotely using SLIP, the 


recommendations about using remote resources should still be observed. 
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This section describes the backup and restore facilities provided as part of the SPARCbook 2 
implementation of Solaris. It gives information on making and restoring backups and provides 
information about what to do if your hard disk is corrupted and you need to restore its contents from 


SCSI or from an attached network. 


The SPARCbook Solaris Operating System is provided on a CD with your 
SPARCbook. If you do not have access to a SCSI CD-ROM drive or to a Sun 
workstation with an attached CD-ROM drive, a you are strongly advised to make a full 


system backup on tape before you use the SPARCbook. 


The Solaris Operating System contains many facilities for automated backup in a large 


networked environment. This guide only describes basic backup and restore facilities 
to allow you to rebuild the disk in case of system corruption. For a complete 
description of the backup and restore capabilities of Solaris you will need to refer to 


the documentation outlined in ‘FURTHER READING’ on page 265. 
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This section describes how to make a backup of the supplied operating system to a tape drive 

attached either to the SPARCbook 2’s SCSI interface, or to a remote system. The remote system is 
assumed to be a Sun Workstation. However, other remote machines using TCP/IP networking with 
access to a backup media will work equally well. This procedure may be used at any time to create 


a complete backup of your system. 


Before attempting to make a backup over the network, you need to ensure that you can 
communicate with the remote machine. It is assumed that the SPARCbook and remote machine are 
connected on Ethernet and that you have set up the configuration so that you can perform 
commands on the remote machine. To verify this, login to the SPARCbook as root and enter the 


following command: 
# rsh [system] uname -n 
Where [System]is the name of the remote system. 


If the command executes successfully, the remote system should print its name. If you require 


information about remote command execution, please refer to “Configuring the Network’. 


Before you attempt back up the hard disk filesystem you must ensure the following: 


¢ You are the only user on the system, logged in as root 

« You are not using the network and no distributed file systems from the network are 
mounted onto your machine 

* You have installed a tape into the remote system tape drive and it is not write 


protected. 


Remote Backup 


To make a backup of the operating system to a remote system, type the following command: 


# makenetbu system [device] 


system is the name of the remote system. 
device is optional. By default the name /dev/nrst8 is used on the 
remote system. You may specify an alternate device, but it must be 


a no-rewind device. 
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The default device name assumes that the remote system is a Sun workstation running SunOS 4.1.x. 


If you use a different system for the backup you may need to specify the device name. 


The backup proceeds automatically and reports progress. To backup the distributed SPARCbook 
Operating System over the Ethernet to a SPARCstation IPC takes about 25 minutes. During the 
Ethernet backup the minifs, if it is available, is automatically stored as the first file on the tape. 
The minifs file takes up over 2Mbytes of space on the SPARCbook disk and is not required for 
normal operations, but is needed if you want to restore the disk. If you perform amakenetbu 
operation without minifs present, the utility will report that there is no minifs file present and 


continue. 


Local Backup 


To make the backup to a local tape type the following command: 


# makebu system [device] 


device is optional. By default the device name /dev/nrst8 is used. You 


may specify an alternate device, but it must be a no-rewind device. 


After you have made the backup you can remove the minifs file from the main system with the 


command: 
# makeminifs -d 


Warning: you cannot now make another minifs backup. 
Do you want to continue (y/n) 


y 
# 
You should ensure that you have two backups of the minifs before you remove it, as 


you cannot perform a restore operation without it. As an alternative to making a full 
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backup, which includes the minifs file, you can use the network remote copy (rcp) 
to save the minifs on a remote machine. See ‘USING THE NETWORK 
INTERFACE’ on page 187 for further information on rep. To do this use the 
following command: 

# rep /stand/minifs system: filename 
where system is the name of the remote system to store the file and filename is where 


to save it on that system. 
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Carrying out the Restore procedure replaces all the existing data on the hard disk. You 


will not be able to recover any existing data after you have started the procedure. 


You may need to restore the operating system for a variety of reasons, such as to recover from disk 
corruption, to install a later release of the operating system or to install SPARCbook OS Lite in 
place of the factory installed version. To recover from disk corruption, you will be able to restore 
the operating system from a tape backup or from the distribution CD. To update the operating 


system or install SPARCbook OS Lite you will need to restore from the distribution CD. 


Before changing or updating the SPARCbook 2 Operating System, you should consult 


the Solaris 1.0.1 Release Notes, which accompany each system and each distribution 


CD, for additional information available since the publication of this Guide. 


A CD-ROM drive or tape drive may be connected directly to the SPARCbook 2 system via the 


SCSI interface, or may be connected to remote system with a CD-ROM or tape drive. 


Restoring the file system involves two stages. First, you load the minifs onto the SPARCbook 
hard disk and then you restore the main file system. On completion of the second stage, the 
SPARCbook system must be rebooted. 


The restore procedure is started from the resident firmware start-up sequence. This caters for the 


possibility of your hard disk being completely corrupted. 
Turn the SPARCbook 2 system On, or if the system is already On use Reset. 


Press the On switch To turn the machine on 


Press Alt-Esc-R To reset the machine 
Press a key to stop the automatic start-up sequence and the monitor menu will be displayed. 


1> Continue with Automatic System Startup Resume 
2> Boot Operating System or file 


3> Standalone Restore Restore hard disk 
4> System Administartion 
5> System Diagnostics Full Diagnostics 


Enter Choice> 3 
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To restore the operating system select Standalone Restore (option 3). A new screen will prompt you 
to choose between Ethernet or devices connected to the SCSI. 

1> Restore from SCSI Floppy Disk 

2> Restore from Ethernet 


3> Restore from Hard Disk or CDROM 
4> Restore from SCSI Tape 


Restoring the minifs over Ethernet 


Before the minifs can be loaded from a remote system over the network, the minifs 


must first be transferred from the tape and onto a remote system file so that it is 


accessible to the SPARCbook. 


Load a backup tape with a minifs on into the tape drive on the remote system and then 
restore the minifs file to a location on the remote system. For example, to restore it to 
the /tmp directory on a Sun workstation type the following on the Sun workstation: 

# dd if=/dev/nrst8 of=minifs ibs=256k 

# 
After a few minutes, lines similar to the following will appear, showing that the 
minifs file has been read from the tape. 

9.1 records in 

9.1 records out 
Note that the non-rewind tape device /dev/nrst8 was used in this example. This 
indicates that the tape is ready for the main disk data files restore operation. It should 
not be removed from the drive until the restore operation is complete. If you are 
restoring a backup made on a different tape, without the minifs, you should change 


the tape to the backup you want to restore. 
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If you choose to restore from Ethernet, option 2, the system will prompt for an Ethernet logical 
address (Internet address) and the file name on the remote machine. You should enter the requested 
information. For example, to restore the minifs from the /tmp directory on a remote machine 
with an Internet address of 192.9.200.100 to a SPARCbook with an Internet address of 
192.9.200.52, you would type the following: 


Enter Network Address of machine where 

minifs resides, in numerical format (eg 192.9.200.52). 

The remote machine must be able to handle Trivial File Transfer 
Protocol (TFTP) requests. 


Server Network address (default 0.0.0.0) > 192.9.200.100 
SPARCbook Network address (default 0.0.0.0) > 192.9.200.52 
Enter File Name > /tmp/minifs 


If you are unsure about the Internet address of the remote machine you should refer to ‘Configuring 


Ethernet’ or consult the machine’s owner or system administrator. 


For the above step to succeed, the /etc/hosts file on the remote system must 


contain your address and it must be configured to run the Trivial File Transfer Protocol 
(tftp). Refer to ‘Configuring the Network’ for information on /etc/hosts. To 
start up t£Etp on a Sun workstation running SunOS 4.1 you may need to edit the file 
/etc/inetd.conf and remove the # comment symbol] at the start of the t£tp line. 
If the line has a -s argument you will need to remove that as well. If you make 
changes to this file you will need to send a signal to inetd to ask it to reinitialize as 
follows: 

# ps -ax | grep inetd 

# kill -HUP [inetd.pid] 


{inetd.pid] should be replaced with the process ID number from the first command. 
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Restoring the minifs Locally 


If you choose to restore from SCSI, the system will prompt for the SCSI device type to restore 


from. 


1> Restore from SCSI Floppy Disk 
2> Restore from Ethernet 

3> Restore from Hard Disk or CDROM 
4> Restore from SCSI Tape 


Enter Choice> 


If you select the option to restore from tape, or option to restore from CD-ROM, SPARCbook 2 will 
proceed to read in the minifs and copy it onto the hard disk. If you restore from floppy, you 


should ensure that the floppy disk in the drive has the minifs on it. 


Restoring the Main File System 
When the minifs has been loaded onto the SPARCbook successfully, the following menu will be 
displayed: 


1> Boot Default File 
2> Boot Alternate File 
3> Change Default File 


Enter Choice> 2 
Select the option to boot an alternate file and then, from the next menu, select the option to boot 


from the hard disk: 


New Source for Boot File 
1> Hard Disk or CD-ROM 
2> SCSI Floppy Disk 

3> Ethernet 

4> SCSI Tape Drive 


Enter Chioce > 1 


Then when prompted, enter the following file specification: 


Enter file spec> 3 1 vmunix 
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This contains just enough to install the rest of the Operating System onto the SPARCbook 2’s hard 


disk. Once booted the minifs will prompt for the type of restore operation. 


SPARCbook Standalone Restore 


Select restore from Floppy Disks Ca) 
restore from Ethernet (2) 
restore from SCSI-CD (3) 
restore from SCSI-Tape (4) 
Choice> 


The procedure following this stage will depend upon whether you are restoring the Operating 
System from a tape backup, CD-ROM or from a set of floppy disks, and whether a drive is attached 
to the SPARCbook’s SCSI interface or to remote machine. 


Restoring The Main Filesystem Over Ethernet 


If you are restoring the operating system over Ethernet, the system will prompt for an Ethernet 
logical address (Internet address) and the file name on the remote machine. You should enter the 
requested information. For example, to restore the operating system from a remote machine called 
juno with an Internet address of 192.9.200.100 to a SPARCbook called mars with an Internet 


address of 192.9.200.52, you would type 1 and then the following: 


Enter remote machine name ? []: juno 
Enterremotemachinenetworkaddress?(eg192.9.200.1):192.9.200.100 
Enter SPARCbook machine name ? [sSparcbook]: mars 

Enter SPARCbook network address ? (eg 192.9.200.2):192.9.200.52 


If you are restoring from a CD-ROM attached to the remote machine, you will need to enter the 
name of the directory on which the CD-ROM is mounted in response to the next prompt and then 
confirm that the device is a CD-ROM. For example, if the CD-ROM was mounted onto a directory 
called /cdrom, then the full path name would be /cdrom. If you are restoring from a tape 


backup, you should press Enter in response to the next two prompts: 


Enter remote device or mount-point ? [/dev/rst8] 
Is remote device a CD ROM (y/n) [n]: 


You will be asked to confirm that the information entered is correct. If you are satisfied with your 


responses, type Y: 
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Is all of the above information correct (y/n) [n] Y¥ 


You will be offered two load options for the Solaris SPARCbook version of the operating system: 


Select option to load 
(1) Solaris-1.0.1-SPARCbook-RevB-Factory 
(2) Solaris-1.0.1-SPARCbook-RevB-Lite 


Choice> 


The first option selects the version of the operating system which is loaded onto all machines before 
they are shipped. This version occupies 51Mbytes. The second option selects a compact end-user 
version of the Solaris Operating System which includes an optimized UNIX kernel, file system, 


OpenWindows V3 and the Nomadic Computing Environment. This version occupies 38Mbytes. 
Following this, you will be asked to confirm the information once more: 


!! WARNING !! 
Continuing will destroy any existing hard disk data 
Continue [Y/N] Y 


Type y if you are sure that all of the information you have typed in is correct. 

If you have two internal hard disks, the following prompt will be displayed: 
The second disk may also be initialized at this time. This will 
destroy any data on your second disk. Do you wish to initialize 
this disk (y/n) [n] 

If you enter N, then the second disk will not be changed, but it will not be mounted automatically 


when the SPARCbook is next booted. 


You are able to configure the factory load version of the operating system to suit you 


own particular requirements. For further information on this topic, please refer to the 


chapter “CUSTOMIZING THE SPARCBOOK OPERATING SYSTEM’. 


Following this, the restore operation will proceed. Further intervention will not be required unless 


the backup uses more than one tape. 
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The SPARCbook restore facility will restore files onto the same partitions as when the 


backup was made. If you have changed the partition table it will give you the option of 


using the original partition table or the current one. Depending on the partition sizes it 


may only be possible to restore the backup to the original table. Refer to ‘DISK 


LAYOUT AND FILE SYSTEMS’ on page 258 for more information on disk 


partitions. 


Restoring The Main File System Locally From CD 


You would use this option if you wish to install a later release of the operating system or load 


SPARCbook OS Lite in place of the factory load version. If you restore the operating system from a 


locally attached CD-ROM then the following dialog will proceed. 


SPARCbook Standalone Restore 


Select restore 
restore 
restore 
restore 


Choice> 2 


Is all of the above 


from 
from 
from 
from 


Floppy Disks (1) 
Ethernet (2) 
SCSI-CD (3) 
SCSI-Tape (4) 


information correct (y/n) [n] Y 


You will be offered two load options for the Solaris SPARCbook version of the operating system: 


Select option to load 
(1) Solaris-1.0.1-SPARCbook-RevB-Factory 
(2) Solaris-1.0.1-SPARCbook-RevB-Lite 


Choice> 


The first option selects the version of the operating system which is loaded onto all machines before 


they are shipped. This version occupies 51 Mbytes. The second option selects a compact end-user 


version of the Solaris Operating System which includes an optimized UNIX kernel, file system, 


OpenWindows V3 and the Nomadic Computing Environment. This version occupies 38Mbytes. 


Following this, you will be asked to confirm the information once more: 


!! WARNING !! 


Continuing will destroy any existing hard disk data 


Continue [Y/N] Y¥ 
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Type y if you are sure that all of the information you have typed in is correct. 

If you have two internal hard disks, the following prompt will be displayed: 
The second disk may also be initialized at this time. This will 
destroy any data on your second disk. Do you wish to initialize 
this disk (y/n) [n] : 

If you enter N, then the second disk will not be changed, but it will not be mounted automatically 


when the SPARCbook is next booted. 


You are able to configure the factory load version of the operating system to suit you 


own particular requirements. For further information on this topic, please refer to the 


chapter ‘CUSTOMIZING THE SPARCbook OPERATING SYSTEM’. 


Restoring the Main File System from a Local Tape Backup 


You would use this option if you wish to install a later release of the operating system or load 
SPARCbook OS Lite in place of the factory load version. If you restore the operating system from a 


locally attached CD-ROM then the following dialog will proceed. 


SPARCbook Standalone Restore 


Select restore from Floppy Disks (1) 
restore from Ethernet (2) 
restore from SCSI-CD (3) 
restore from SCSI-Tape (4) 


Choice> 4 
Enter norewind device [/dev/nrst8]: 
Skip minifs archive (y/n) ? [n] y 


!! WARNING !! 
Continuing will destroy any existing hard disk data 
Continue [Y/N] Y 


Type y if you are sure that all of the information you have typed in is correct. 
If you have two internal hard disks, the following prompt will be displayed: 
The second disk may also be initialized at this time. This will 


destroy any data on your second disk. Do you wish to initialize 
this disk (y/n) [n] 
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If you enter N, then the second disk will not be changed, but it will not be mounted automatically 
when the SPARCbook is next booted. 


Type Y to continue and the restore operation will proceed. Further intervention is not required 


unless the backup uses more than one tape. 


The SPARCbook restore facility will restore files onto the same partitions as when the 


backup was made. If you have changed the partition table it will give you the option of 
using the original partition table or the current one. Depending on the partition sizes it 
may only be possible to restore the backup to the original table. Refer to “DISK 
LAYOUT AND FILE SYSTEMS’ on page 258 for more information on disk 


partitions. 
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APPLICATIONS 


Using the industry standard SPARC processor and the SunOS 4.1.2 based Solaris 1.0.1 Operating 
Environment, SPARCbook 2 provides access to several thousand third party applications. However, 
not all SPARC applications will necessarily run on the SPARCbook 2. The main limitations are as 


follows: 


* Older SunView applications are not supported. SunView depends on Sun 
Microsystems specific graphics hardware which is not available within the 
SPARCbook product. Applications to run on the SPARCbook must either use X 
Window as their graphics system, or must be written for OpenWindows. The 
SPARCbook Operating System uses X Window Release 4 and OpenWindows 
Version 3, but you may run earlier X or OpenWindows applications directly on the 


SPARCbook. SunView applications are not supported. 


¢ Applications that require the existence of Sun specific hardware, such attached SBus 
hardware, or that make direct calls into undocumented device driver interfaces in the 
Sun kernel, will not run on the SPARCbook. 


¢ Applications that use Sun or other vendor specific hardware (such as IDPROMs) for 


licensing may not run on SPARCbook. 


In general all third party X or OpenWindows applications written for Sun-4 and compatible 
workstations will run on the SPARCbook provided they do not conflict with the above 
requirements. In particular applications that meet the SPARC Compliance Definition (SCD) will 
run on SPARCbook. Common third party applications that have been tested on SPARCbook 
include FrameMaker (Frame Technology Corp), Lotus 1-2-3 (Lotus Corp), Wingz (Informix Corp), 
WordPerfect (WordPerfect Corp), Write Draw & Paint (Island Graphics) and 20-20 (Access). 
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INSTALLING SUNOS 4.1 APPLICATIONS 


Installing SunOS 4.1 applications can require minor modifications to the steps laid out in the 
application manual depending on the hardware configurations the installation process requires. All 
the Sun utilities for installing and running applications are available on the SPARCbook. You can 


install applications using one of the following methods: 


METHOD REQUIREMENTS 


1 Installation from local CD or tape. CD or tape drive connected to the 
SPARCbook 2’s SCSI interface. 
* Application supplied on CD or tape. 


2 Installation from remote floppy, CD or Floppy disk, CD or tape drive connected to 


tape. a remote system. 


SPARCbook 2 and the remote system 


connected via a network. 


Method | is usually catered for in the application standard installation procedure and you should 
refer to the application installation documentation for further information. Method 2 may or may 
not be covered in the application documentation. To install an application from a remote system 
you will normally need to carry out the first stages of installation on the remote machine. Wherever 
possible follow the application documentation. If this does not cover remote installation try the 


procedures outlined in the next section. 


Installing Applications Using a Remote Machine 


Most applications are installed in two stages. The first stage involves loading the application files 
off the shipping media (floppy, tape or CD) and onto a directory on the local machine, and the 
second stage involves initializing the files, licensing the application if necessary, and starting up the 


application. 


In this situation you can normally use the networking facilities to copy the application files over the 
network and into the SPARCbook 2 system before continuing the installation process on the 
SPARCbook 2. 
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For example, assume that you have loaded the application files into a remote machine called mars 
in a directory called /opt/app. In order to maintain file ownerships and layout, it is best to use 
the tar command to package the application while transferring it. On the local SPARCbook 2, 
create a directory for the application (for example a directory named /opt /new) and remote copy 


across the network using the tar command onto the SPARCbook as follows: 


# mkdir -p /opt/new make the directory 
# cd /opt/new change directory 
# rsh mars “cd /opt/app; tar cf - .” | tar xvf - 


The last command causes the application files to be archived into a file which is then ‘piped’ 


between the remote machine and the local SPARCbook to be un-archived in the local directory. 


This assumes that networking is fully operational between the two systems. Refer to 


‘CONNECTING TO THE NETWORK’ on page 189 for further information on setting 


up networks. 


The application files are now installed on the local SPARCbook 2 machine, and you should be able 
to continue the installation process on the SPARCbook 2. After you have completed the installation 
you should remove the files on the remote machine. In the example given above the command 


rm -rf /opt/app would be carried out on the machine mars. 


> This method may not be possible, or may not work, with all applications. If you 
experience difficulties in installing applications you should contact your application 


|] vendor or SPARCbook Technical Support. 


|NoTES On smaller SPARCbook configurations, running large applications may cause system 
“a resource limitations to restrict the application operation, or in some case prevent it 
starting up at all. Refer to ‘MEMORY USAGE AND SWAP SPACE’ on page 283 for 


further information on how to overcome such problems. 
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SUNOS GRAPHICS INTERFACES 


SunOS applications are designed to run on a standard Sun Microsystems hardware configuration. 
While the software should make calls to standard system interfaces and libraries in order to 
conform with the industry standards, there are some difficulties in the area of graphics. Many 
applications assume the presence of a high resolution screen which may vary from the Sun 
Monochrome 1152 x 900 configuration to color 1280 x 1024 frame buffers. In general a higher 
resolution does not pose a problem, but a lower resolution can result in not all of the information the 


application developer intended being completely visible on the screen at one time. 


SunOS applications for X or OpenWindows will run unmodified on the SPARCbook 2. The X11 
and OpenWindows protocols ensure that applications will normally use windows that are only as 
large as the display itself. However, while portable applications, and those conforming with the 
SPARC Compliance Definition, should run and present no problems, certain applications may have 
difficulties with the small format internal screen of SPARCbook 2. In order to address this, several 
system software interfaces are built into the SPARCbook version of the Solaris 1.0.1 Operating 


System. 


VIRTUAL DESKTOP 


By default, the SPARCbook 2 Operating System uses a Virtual Window Manager for the 640 x 480 
screen, The Virtual Window Manager allows you to display a 640 x 480 window into a virtual 
desktop which may be as large as you like. For example the default configuration gives a virtual 
desktop of 1920 x 960 pixels. Facilities are provided to pan a window of 640 x 480 over the entire 


virtual desktop, or to move application windows into the viewing window. 


APPLICATIONS ON A SMALL SCREEN 


Since most applications are designed to run on high resolution screens the standard font sizes used 
look large on the smaller SPARCbook 2 display. This, in turn, makes the applications windows 
large, often exceeding the size of a single panel of the Virtual Window Manager. Most applications 
include facilities to change the size of fonts used on the display. This allows you to configure the 


application for the SPARCbook 2 display. 
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The standard fonts provided with the SPARCbook 2 include the families Lucida, Courier, Times, 
Helvetica and Palatino. Many others are available on the full CD version of the operating system. 
Each font is available in different sizes (and for the NeWS PostScript server can be used as 
completely scalable fonts). Typically applications will use 12 or 14 point text size for text, window 


buttons, menus and so on. 


On the SPARCbook the OpenWindows applications and standard X Window application interfaces 
are set up for operation on a small screen using 10 point font sizes. This is achieved by setting the 
system wide Xdefaults file in /usr/1ib/openwin, and by configuring the DeskSet tools to start 
up in ‘small’ mode in the openwin-menu files. You should not alter these unless you fully 


understand these files. 


For a full discussion of Fonts, Xdefaults, and facilities for changing the system 


configuration you will need to refer to the documentation discussed in ‘FURTHER 
READING’ on page 265. The standard SPARCbook version of the Solaris Operating 


System has been optimized for the LCD screen. 


All applications that run under X and OpenWindows use a set of resources. Many of these 


resources can be changed to tailor the application to your requirements. 


You may want to reduce the application font size from its default to 10 point to improves its 
appearance on SPARCbook 2. To do this, you will need to refer to the application documentation, 
but typically the application will use a file from the directory /usr/openwin/lib/app- 
defaults, or /usr/lib/X11/app-defaults. Often you can copy sucha file into your own 
home directory and modify your own copy. Then, whenever you start up the application, it will 


consult the resource file in your home directory and initialize itself accordingly. 


Some applications have easy ways to configure for different screen or font sizes. For others you 


may have to modify the resource files yourself. 


You should only attempt the following procedures if you are prepared to experiment in 


application configuration. The following examples will not work for all applications 


Oo=Q 


and you should always refer to the application documentation before attempting any 


reconfiguration. 
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Look for lines similar to the following in resource files if they exist: 


app* foadobe-courier-medium-r-normal--14-140-75-75-m-90-iso08859-1 


This is a font specification for the application which includes information fields with the foundry, 
font family, point size, pixel sizes, and so on. A program called xfontsel allows you to look at 


fonts and select different fonts for your application. 
For example, start up xfontsel from a command tool as follows: 


%$ xfontsel & 


After a short time a window will appear with a row of menu options along the top. To look at the 
example font, move the pointer to the Fndry box and press Menu. Move the pointer down to the 
adobe selection and release the pointer. The names that are not in bold are not available on the 
bundled SPARCbook 2 Operating System. Repeat this for each field until the message at the top 


right indicates that only | font match. The window should now show the selected font and its name. 


xfontsel 


24 fonts match 


-fndry-fmly-wght—slant-sW dth-adstyl_pxlsz—ptSz_re sx_re sy—spc —avg W dth-rgstry-enc dng 
- 


mm 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijklmnopaqrstuywxyz 
0123456789 


This font is the equivalent of the full font name given above since wild cards symbols, such as ‘*’, 
are allowed in a font specification, provided only one font matches. Now using the pointer and 

Menu on the pxlsz option, change the pixel size from 14 point to 10 point. The font is shown and 
can be used by applications. You can, therefore, change the initial 14 point definition to 10 point by 


changing the resource file line to either of the two equivalents below. 


-adobe-courier-medium-r-normal--10-—*-*-*-*-*-*-* 
-adobe-courier-medium-r-normal--10-100-75-75-m-60-is08859-1 
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You can see the full name by selecting each of the wild card fields and seeing the value of the 


selected font. 


to the original file. ee ———S 


The information in this section provides only guidelines on configuring applications, 


and does not necessarily apply to all applications. You must refer to the application 


documentation for detailed procedures on configuration to meet your requirements. 


OPENWINDOWS SUN COMPATIBILITY MODES 


From a software standpoint, the SPARCbook 2 display hardware closely resembles a Sun color 
graphics 3 (CG3) adapter; with 8 bits per pixel arranged in a packed array of up to 1 Mbyte in size. 
This enables the configuration of the Sun standard display resolution of 1152x900, and support for 
the internal LCD display resolution of 640x480. 


The SPARCbook 2 display hardware may be configured by using the fbconfig command, either 
directly from the command line or through using the External Display submenu of the Workspace 
Portable menu in OpenWindows. Standard configurations are provided for the internal display only, 
for internal display with external VGA enabled, and for external Sun 1152x900 and 1024x768 
displays only. Additional configurations may be added as required, as explained in ‘Connecting 


External Displays’. 


The SPARCbook 2 OpenWindows server is capable of using the display hardware directly, as it is 
on a standard Sun system, or indirectly via an Emulated Framebuffer. The first of these uses native 
mode and provides the best performance for animations, while the second use the emulated 
framebuffer mode (the default mode) to provide the Portable Power Windows feature of 
SPARCbook 2. 


Native Mode 


In the native mode, the OpenWindows server drives the display hardware directly, supporting 


640x480 pixel dimension of the internal screen or the dimensions of the selected external display. 
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On a Resume in native mode, the display is configured as it was in when previously Saved. If this is 
an external configuration and an external display is not connected, the internal display will be 


blanked and there will be no visible display. 


OpenWindows can be aborted in this case using Alt-F-Del. 


Emulated Framebuffer Mode 


In the emulated framebuffer mode, the default framebuffer dimensions are set to the those of the 
current configution, e.g. 640x480 for the internal display. To set the dimensions to the maximum 


size (twice the size in both directions) the -maxfb option is used when starting OpenWindows: 


$ openwin -maxfb 


When the dimensions of the emulated framebuffer exceed the minimum in either direction, the 
server provides the Zoom-In and Zoom-Out features of Portable Power Windows. OpenWindows 
starts-up fully Zoomed-Out, combining groups of four pixels from the emulated framebuffer (a 2x2 


square) into one pixel on the display (4:1). 


When you Zoom-In (using Alt-PgUp), the SPARCbook 2 displays a portion of the emulated 
framebuffer at 1:1. The portion of display that is visible is controlled by the position of the cursor 
when you Zoom-In. The cursor should be placed at the top left hand corner of the area to be zoomed 
(the default operation) or, if the -zoomcenter option is used, at the center of the area to be 
zoomed. Once the Zoom-In has been performed the cursor may be moved around normally. If the 
cursor is pushed to the edge of the displayed portion, the visible display is panned round the 
emulated framebuffer in the direction of cursor movement. This can be suppressed using the 


-zoomconstrain option. 


To obtain specific emulated framebuffer dimensions, the -width and -height options are used 
when starting OpenWindows. For example, to set a screen size of 1000 wide by 700 tall you would 


use the command: 


$ openwin -width 1000 -height 700 


A shorthand is provided to obtain the common Sun dimensions of 1152x900 is: 


$ openwin -sunfb 
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The emulated framebuffer mode provides a high level of support for in-office and out-of-office use 
where the display configuration needs to be switched between a large external Sun monitor and the 


640x480 internal screen. 
After a Save and Resume, or by user command, the display will revert to the internal 640 x480 


display with the Zoom—In and Zoom—Out function active. 


Tailoring Fonts For Large Framebuffers 


All fonts and windows will appear to be extremely small on a large framebuffer, because the 
SPARCbook is specifically configured to operate OpenWindows in a ‘small’ mode for the 
embedded screen dimensions. To operate in the monochrome mode you may prefer to change some 
of the default font and application sizes by copying the files from the directory 


/usr/openwin/1lib/monochrome into your home directory. The following files are 


available: 
-Xdefaults Changes the X Window environment to use 14 
point fonts by default. 
-openwin-menu Uses ‘large’ versions of the DeskSet tools. The 
default is to use the ‘small’ version. 
-openwin-menu-programs As for .openwin-menu 
Be careful to save these files first if you already have your own versions in your home 
i) directory. If you want to use these files you should copy them into your home directory 
Q 


using the File Manager or Solaris tools. 
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CUSTOMIZING THE 
SPARCbook OPERATING 
SYSTEM 


SPARCbook 2 is shipped preloaded with a ‘Factory’ version of the Solaris Operating System which 
occupies about 51 Mbytes of disk space. The entire Solaris 1.0.1 Operating System for SPARCbook 
2 is supplied with each unit on compact disk, along with an optional version of the Solaris 
Operating System called SPARCbook OS Lite. This chapter discusses how to customize the 
SPARCbook Operating System loaded onto your unit to meet your own particular requirements, 


and covers the following topics: 


¢ The bundled factory loaded SPARCbook Operating System 

¢ The differences between the SPARCbook version of Solaris 1.0.1 and that provided 
for a Sun workstation or ‘clone’ 

¢ How to change the bundled operating system configuration 

¢ Using the CD-ROM files 


Reconfiguration of the SPARCbook Operating System requires access to a CD-ROM 

drive or to a remote Sun workstation or server. In the later case the remote Sun and the 
SPARCbook 2 must be connected over Ethernet. Please refer to ‘CONNECTING TO 

THE NETWORK’ on page 189. 
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Before making changes to the operating system you are strongly advised to consult the 


Release Notes which accompany each SPARCbook system. 


CLUSTERS 


The Solaris 1.0.1 Operating System (SunOS 4.1.2) is packaged as a set of modules, otherwise 
known as clusters or packages. Each cluster consists of a set of files applicable to a particular 


application. 


The Solaris 1.0.1 packages are not the same as the Solaris 2.0 UNIX System V Release 


4 packages. Hence for the rest of this section the term cluster will be used rather than 


package to avoid confusion. 


The SPARCbook Solaris CD contains a complete implementation of the Solaris 1.0.1 product from 
SunSoft Inc., with the exclusion of the SunView clusters, which are not supported on the 
SPARCbook 2 product, and the OpenWindows Version 2 clusters which are replaced with the 
OpenWindows Version 3 product. In addition, the CD contains a complete configuration system, 
comprising over 150Mbytes that can be mounted on a SPARCbook 2 as a server directory. Many 
functions can only be carried out by installing clusters onto your local system (for example using 
the RFS networking option). However, using the complete tree installed on the CD you can access 
read-only data such as additional fonts, OpenWindows demonstrations and on line manual pages. 


Some examples on using this facility are provided later. 


THE SPARCbook BUNDLED OPERATING SYSTEM 


As shipped, the SPARCbook Operating System, when loaded during manufacture, occupies 
51Mbytes of disk space, excluding the space allocated for the swap area and the minifs files 
which are normally removed after having been backed up. On a machine with a single 250 Mbyte 
disk, this leaves 167 Mbytes for user files and up to 32Mbytes of combined temporary file system 
(/tmp) and swap space. Facilities are provided to increase the available user space by removing the 


programming tools which provides, approximately, a further 1|OMbytes of user space. 
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THE SPARCbook BUNDLED OPERATING SYSTEM 


Disk manufacturers use the term megabyte to refer to 1,000,000 bytes (10°), rather — 


than the operating system view of a megabyte which is 1,048,576 bytes (29), For 


example, the smallest SPARCbook 2 configuration has a disk over 250 ‘disk’ 
megabytes, corresponding to approximately 238 ‘operating system’ megabytes. This 
can lead to considerable confusion. In this Guide all figures are given in operating 
system Mbytes. ee 

The bundled operating system contains the following Solaris 1.0.1 clusters. These have been 


modified as described below for the SPARCbook 2 implementation. 


CLUSTER cecal DESCRIPTION 
root 2 Sun root file system 
usr 14 Core required system files 
Install 1 System configuration and installation files 
Networking l Networking interface (NFS) 
Kvm 2 Kernel architecture dependent files 
Text Text processing software 
uucp | Communications software 
OWV3 min 2 OpenWindows V3 run time package 


The following main changes have been made from the SunSoft Solaris 1.0.1 files. 


« The kvm tree has been changed. The device directory has been reduced in size, and 
SPARCbook 2 devices added. No standalone facilities are available, except those 


provided by the minifs system. 


¢ Solaris 1.0.1 from Sun provides SunView and OpenWindows Version 2. No SunView 
support is provided for SPARCbook 2, and the windowing system is the more recent 
OpenWindows Version 3. The SPARCbook 2 implementation corresponds to the 
minimal implementation of OWV3 with the removal of the avant-garde font family 
and the addition of SPARCbook 2 NCE and productivity tools. 


¢ The terminfo directory has been removed, except for the minimum number of 


terminals required to support SPARCbook 2. 
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RECONFIGURING THE OPERATING SYSTEM 


There are three ways that the operating system can be changed. The first is to remove some of the 
existing software, the second is to add clusters and the third is to load SPARCbook OS Lite. The 


next sections describes these approaches. 


Removing Programming Software 


As shipped, the SPARCbook 2 version of Solaris 1.0.1 includes the Sun C Compiler, programming 
tools, archive libraries and include files. If you intend to use your SPARCbook 2 for end user 
applications only, and do not intend to compile any software you can create an additional 10Mbytes 


of disk space by removing the programming tools. 
To do this login to the system as root and enter the following command: 


# /usr/etc/install/remove_programmer 


A warning message will be printed and the software will be removed if you confirm that you wish 


to proceed. 


The software cannot be reinstalled once removed except using the add_clusters 


facility below. 


You should also remove the minifs if you backed it up, or have access to CD 


facilities. This will free a further 2Mbytes of disk space. See the chapter ‘BACKUP 
AND RESTORE’ on page 215 for further information. 
Adding Clusters 


To add clusters you need to have a CD-ROM connected to the SPARCbook 2. You can do this is 


one of two ways: 
* A locally attached CD-ROM system via the SCSI Interface. 


¢ Aremotely attached CD-ROM system connected to a remote Sun-4 workstation or 
SPARCbook. 
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— Documentation on the facilities available in these clusters is not provided in this User 


ff Guide, Full reference documentation is available in the documentation outlined 


‘FURTHER READING’ on page 265. | 


The following clusters are available: 


SIZE 
CLUSTER (Mbytes) DESCRIPTION 
— 

debugging l Profiling libraries for debugging programs 

games 3 Traditional UNIX games 

manual 8 On-line manual pages 

misc 2: Standard missing files such as terminfo and 
some include files 

owuser 17 Additional OpenWindows V3 fonts, MIT utili- 
ties, manual pages and on-line handbooks 

owdemo 8 Additional OpenWindows V3 demos and 
images 

owprog 22 OpenWindows V3 programmers’ environment; 
this requires owfonts as a prerequisite 

prog 10 The programmer’s files removed if you remove 
the programming software 

rfs l RFS networking package 

security | C2-Level security software 

shlib: custom 2 Software for building shared libraries 

sys 3 Kernal building software 

system_v 4 Additional SystemV and X/Open compatibility 
software 

tli l Transport Layer Interface (TLI) 

versatec 6 V-80 printers 


244 


RECONFIGURING THE OPERATING SYSTEM 


To add a cluster you must have access to the CD-ROM directory. You can gain access to a 


CD-ROM connected to the SCSI interface using the following commands (as the superuser): 


# cd / 
# mkdir /cdrom 
# mount -r /dev/srO /cdrom 


# 


You will only need to make the directory if it does not already exist. 
You can now access the CD-ROM files in the /cdrom directory. 


If you are using a remote CD-ROM facility you will need to export the remote file system and 
mount it into your file system (refer to ‘Setting up a Distributed File System’ for further 
information). For example, to mount the directory from a remote SPARCbook called venus which 


had a CD-ROM mounted as described above, you would type: 


# ca / 

#mkdir/cdrom 

# mount venus:/cdrom /cdrom 
# 


The add_clusters program is primarily intended for adding software but you may also use it to 
delete previously added clusters. To start up the program type: 
# /usr/etc/install/add_clusters [directoryname] 


The directory name is optional (do not include the brackets if you use it) and is used to specify an 


alternative directory for the top of the CD-ROM tree. The default is to use the directory /cdrom. 


A menu of the available clusters will now be displayed. The following message will then be 
printed: 
> Select Cluster: 


You should type the number of the cluster you want to install or remove. 


> Select Directory [usr]: 


By default, all additional software is loaded into /usr. If you just press Enter the system will load 
the cluster into /usr. However, if you do not have sufficient space you may wish to install the 
package somewhere else. You may specify an alternative directory by typing the directory name to 


this prompt. 
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Themisc, rfs, security, system_v and tli packages must be installed 


into /usr to operate correctly. 


The following menu will then be printed: 


1. Install Cluster 
2. Remove Cluster 
3. List Cluster 


Enter Choice 


Install Cluster will install the selected cluster onto the SPARCbook. 

Remove Cluster will remove the contents of the cluster from the 
SPARCbook. 

List Cluster will list the contents of the cluster but will not install it. 


After the operation has completed the menu of clusters will be printed again. You may either carry 


out another operation or type Q to exit the add_clusters program. 


Clusters are stored on the CD-ROM as tar files. In addition a complete tree is available on the 


CD-ROM allowing you to choose the files of your choice, as described next. 


Installing SPARCbook OS Lite 


In addition to the full Solaris Operating System, the distribution CD contains a compact end-user 
version of the Solaris Operating System called SPARCbook OS Lite. SPARCbook OS Lite consists 
of an optimized kernel and includes OpenWindows V3 with DeskSet V3 tools, and a set of 


Nomadic Computing Environment tools. It occupies 38 Mbytes of disk space. 


To install SPARCbook OS Lite, you should follow the procedures discussed in the chapter 
‘BACKUP AND RESTORE’ on page 215. 
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MOUNTING THE CD-ROM ON A SERVER 
Many of the facilities available on the SPARCbook Solaris Operating System CD-ROM are not 
required for all users, or are only occasionally needed. For example access to the OpenWindows 
demos and images, and the on-line manual pages might be required only rarely. Using the 
SPARCbook Solaris CD-ROM you can mount the CD-ROM on a server machine and allow access 


to various directories using NFS. 


The server could be a Sun Workstation with an attached CD-ROM or a SPARCbook with a CD- 
ROM connected to its SCSI interface. For example, to allow the manuals to be read by any system 


on the network, you would perform the following on the server machine: 


# mkdir /cdrom If it doesn’t already exist 
# mount -r /dev/srO /cdrom Mount the CD 
Next, follow the instructions in ‘Using Shared Directories’ on page 206 to share or export the 


/cdrom directory. 


On the local SPARCbook a user would type the following to allow access to the on-line manual 


pages: 
# mount -r servername:/cdrom/OS/usr/man /usr/man 


servername is the hostname of the remote server. This will mount the CD 
manual directory onto the local /usr/man directory. Now all 
users on the local machine should be able to look up manual pages 
by using the man command. For example the following command 
from acmdtool prompt will print the manual page for the mkdir 


command: 


%$ man mkdir 


Similarly other directories in the complete distribution tree loaded into the OS directory on the CD 


can be mounted for local SPARCbook use. 
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TECHNICAL REFERENCE 
AND 
FURTHER READING 


This Technical Reference and Further Reading chapter provides detailed technical information 
about the SPARCbook 2 product. This includes the technical specification for the system, 
descriptions of the hardware interfaces, and more in-depth information on the operating system 
devices and drivers. An explanation of the disk drive layout and information about how to change 
the default partition mappings is provided for users who may wish tailor the SPARCbook 2 system 


to meet their own requirements more precisely. 


For further information on the SPARCbook hardware and software interfaces you should refer to 
the Technical Reference Manual which is available as a separate product from your SPARCbook 


supplier. 


At the end of this section there is a brief summary of the reference documentation available for the 


SPARCbook Operating System, from your SPARCbook supplier. 
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TECHNICAL SPECIFICATIONS 


° Processor and Memory 


Processor 


Integer Unit 


40MHz CYM6111 N Chip Module 
Integral CY7C601 


Cache Controller/MMU Integral CY7C604 CMU 
Cache Integral 64K Bytes direct mapped virtual cache 
FPU Integral CY7C602 Floating Point Unit 
DRAM _ 16, 32 or 64 Mbytes with byte parity 
. I/O Interfaces 
Ethernet [EEE802.3 Compliant 
15 pin D Type AUI Interface with SlideLock 
SCSI — Single-ended 8-bit Small Computer Systems Interface 


Mouse/Keyboard 


Serial Interface 


36 pin miniature D Type with cable to 50 pin miniature DT ype 
Combined mouse and keyboard interface, 8 pin mini-DIN 
General purpose async/sync interface, 8 pin mini DIN 

TxD, RxD, CTS, RTS, DCD, DTR - RS232 


Modem _ V.32 14400 bps data with V.42 bis data compression to 57600bps 
Send/receive fax to 9600 bps 
European approved DAAs external to unit 
Audio — Microphone input, speaker output, 8 pin Mini DIN 
° Display 
Internal 640 x 480 sidelit TFT color LCD flat panel 
256 simultaneous colors from a palette of 512/4096 
External Selectable display resolution of up to 1152 x 900 
256 simultaneous colors from a palette of 16 million 
15 Way PS/2 compatible D Type connector 
° Storage 
Hard Disk 250 or 500MB formatted capacity, <12ms average seek time 
° Keyboard 


82 Key notebook-style keyboard 
Mousekey based on Force Sensitive Resistor (FSR) technology. 
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° LEDs 
Green 
Green 
Green 
Red 
. Case and Emissions 


. Power Supply 


Internal 
External 


. Physical 


Dimensions 
Weight 


. Environmental 


Temperature (Operational) 
Temperature (Storage) 
Vibration (Operational) 
Vibration (Storage) 

Shock (Operating) 

Shock (Storage) 

Humidity (Operating) 


. Operating System 


SunSoft Solaris 1.0.1 
comprising 


TECHNICAL SPECIFICATIONS 


External DC supply connected 
Disk active 

User controlled indicator 

Battery Low/Exhausted indicator 


Magnesium Alloy AZ91 Castings 
SPARCbook 2 is certified to FCC Part 15 Class B 


Switched mode PSU/ battery charger. 
Universal Input 110V-240VAC, Output 18V 0-3.1A DC 


11.8” x 8.5” x 1.95” (299.72mm x 215.9mm x 49.53mm) 
Single disk 7.51b/4.9lb (3.45kg/2.22kg) (with/without battery) 
Dual disk 8.01b/5.41b (3.63kg/2.45kg) (with/without battery) 


5 - 40 degrees Celsius 
-20 - 60 degrees Celsius 
5-100Hz 0.25¢ 
5-100Hz 1.2g 


3g 
50 
8-80% RH 


SPARCbook Version B.1 

SunOS 4.1.2 Sun4m architecture 

OpenWindows V3, SPARCbook utilities 

Meets SPARC Compliance Definition (SCD) 1.1 
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CONNECTOR REFERENCE 


This section provides interface information for all the connectors on the SPARCbook 2 computer. 


Connections between the SPARCbook and any peripherals must be made using 


shielded cables to maintain compliance with FCC radio frequency emission limits. The 
SPARCbook uses shielded connectors for all interfaces. When making or specifying a 
cable, you must use screened cables and shielded connectors, and connect the screen to 


the connector’s shield. Refer to Page ii of this User Guide if interference is suspected. 


DC Power Supply 


Connector Type: 2-way 1.2mm Jack Socket 
| PIN. | SIGNAL | 
1 |+18V_ | 
© | 2 OV 


<ol> Ethernet Interface 


Connector Type: 15-way D-Type Socket with slide-lock 
1 . 


g 
C PIN SIGNAL fre PIN SIGNAL at 
veo i, el 9 | Collision 
Me 2 | Collision+ 10 | Transmit~ 
3 Transmit— 11 OV 
4 OV 12 Receive— 
5 Receive+ 13 +12V(Fused) 
6 |0V 14 |0V 
7 NC? 15 NC 
8 OV 


a. NC = Not connected 


The 12V for external transceiver power is fused through a thermally resetting fuse with a trip 


current of 600mA. The fuse will automatically recover after about 30 seconds. 
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) 


Keyboard/Mouse Interface a 


Connector Type: 8-way mini-DIN Socket 


PIN | SIGNAL 


1 OV 


Mouse Rx 


2 
3 
4 
5 Keyboard Tx 
6 
7 
8 


Keyboard Rx 
OV 
5V | 


hs AF Serial Interface 


Connector Type: 8-way mini-DIN Socket 


PIN | SIGNAL 


lel lel [ 1  |DTR a 
ea) (ea) 2 |cTS 
2 1] 3 Transmit 


OV 


Receive 
RTS 
DCD 
NC? 


ony nun fs 


a. NC = Not connected 
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(_J| Display Interface 


Connector Type: 


15-way D-Type Socket (on rear panel) 


PIN | SIGNAL | PIN | SIGNAL PIN | SIGNAL 
1 | Red 6 joy | 1 [NC 
2 | Green T ON 12 | NC 
3 Blue 8 OV 13. | HSYNC 
4 | NC? 9 |NC 14 | VSYNC 
5 | NC | 10 |ov 15 |NC 
a. NC = Not connected 
Connector Type: 13W3 D-Type Socket (on breakout cable) 
PIN | SIGNAL PIN SIGNAL 
1 |NC TI a 
2 NC 7 NC 
3 NC 8 NC 
4 NC 9 NC 
5 CSYNC | 10 OV 
Al Red A2 Green 
| A3 Blue 
a. NC = Not connected 


Ch) Audio Interface 


Connector Type 8-Pin Mini-DIN Socket 


SIGNAL 


ont Dn HR W 


aNC= 


NC? 

NC 

Audio In+ 
NC 

NC 

Audio In— 
OV 

Audio Out 


Not connected 
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& . SCSI Interface 


Connector Type: 36-Pin Micro Miniature D-Type Plug (on rear panel)* 


PIN | SIGNAL PIN | SIGNAL 


1 | SCSID®) 19 | SCSIIO 
19 36 | 
3 | SCSID(7) 21 | /SCSIREQ 
4 |0Vv 22 +|0V 
5 | SCSID(6) 23 | SCSICD 
6 |0V 24 |0V 
7 | SCSID(5) 25 | /SCSISEL 
8 |0V | 26 |OV 
9 | ScsIDé) 27 | /SCSIMSG 
10 |0V 28 |0V 
1 | SCSI(3) 29 | /SCSIRST 
2 |0v 30. | OV 
3 | SCSID(2) 31 | /SCSIACK 
4 |oVv 32. |OV 
5 | SCSI(1) 33 | /SCSIBSY 
6 |0V 34. «| 0V 
17 | SCSID(0) 35 | /SCSIATN 
18 | OV | 36 |+5V 
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Connector Type 50 Way Micro Miniature D-type Socket (on breakout cable) 


Uy u 
25 7 1 
\ Sooecosc08ss8c00008c80e8cen06 | | 
Se ooeosecsecsesesce00e0Rs | 
50 26 
PIN. | SIGNAL PIN. | SIGNAL 
[jo | 26 |TERMPWR | 
2 | SCSID(0) | @ lee 
3. 0V | 28 Inc 
4 | SCSID() | 29 |0V 
| 3 |e 30 | OV | 
| 6  |SCSID(2) 31 /0V | 
| | 
7 |0V | 32 | /SCSIATN | 
8 | SCSID(3) 33 lov 
9 |ov | 34 Jov | 
| 10 | SCSID(4) | 35 |OV | 
11 }0V } 36 | /SCSIBSY | 
12 | SCSID(S) 37. | OV 
13 | ov 38 | /SCSIACK 
| 14 | SCSID(6) 39 «| 0V 
15 |0V | 40 |/SCSIRST | 
16 | SCSID(7) 41 |OV 
| 17 Jov 42 | /SCSIMSG 
| 18 | SCSID(P) 43 | OV 
| 19 Jov 44 | /SCSISEL 
20 ie 45 ‘ov 
21 ov 46 | /SCSICD 
| 22 |GND 47 | OV 
| 23 |nc | 48 | /SCSIREQ 
24 |NC | 49 |ov 


25 | NC 50 | /SCSIIO 


a. NC = Not connected 
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Modem Interface 


Connector Type: RJ11 


A239 6 8 — 


' nT PIN SIGNAL 
LULU on 
2, NC 
LINE 
LINE 
NC 
INC 


Nn BP W 


a. NC = Not connected 
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STANDARD CABLES AND ACCESSORIES 


The SPARCbook 2 system is supplied with a number of standard cables. You may wish to add such 
facilities as an external display, keyboard and mouse, or an external microphone and speakers. The 
interfaces on the SPARCbook 2 use industry standard connectors (or provide industry standard 


connectors an adapter cable) allowing you use standard cables and accessories. 


In the case of the SCSI port, a breakout cable is supplied which allows direct connection Sun 
standard cables and peripherals. In the case of the display interface, you can connect a VGA 
monitor directly to the SPARCbook 2, or using the adapter cable supplied you can connect Sun 


monitors. 


Connections between the SPARCbook and any connected peripherals must be made 


using shielded cables to maintain compliance with FCC radio frequency emission 
limits. You should only use shielded cables for connections to the SPARCbook. Refer 


to Page 2 of this User Guide if interference is suspected. 


If you are specifying cables always refer to the peripheral handbook to verify the pin 
connections on the peripheral equipment you are using. Failure to observe this warning 


could result in damage to the peripheral and/or SPARCbook 2 system 


The chapter “Connecting External Devices’ describes in detail how to connect peripheral devices 
and how to configure the SPARCbook 2 system to work correctly with them. The summary 
opposite provides a quick guide to the available peripherals, the port to which they connect and the 


type of cable you should use to connect them. 


A cable suitable for connecting the SPARCbook 2 serial port to an external modem is also shown 
opposite. To ensure correct shielding, the wire used should have a braided screen which should be 
connected to the connector hoods. Pinouts are provided in the previous section for connectors on 


the back of the SPARCbook 2 system and on all supplied adapter cables. 


254 


STANDARD CABLES AND ACCESSORIES 


SPARCbook 2 


PERIPHERAL ‘AB YP. 
H PORT CABLE TYPE 
Serial Printer (with a DB-25 Serial | Connect via a DIN-8 to DB-25 serial port adapter 
connector) | cable, and DB-25 to DB-25 Null Modem cable. 

7 = a : 7 
VGA Display Display Connect directly the SPARCbook 2 using a 

| standard VGA cable. 

| Sun Compatible Display Display Connect via the adapter cable supplied with 


SPARCbook 2, a and standard Sun monitor cable. | 


ASCII Terminal Serial 


| DIN-8 to DB-25 serial port adapter, and DB-25 to| 
| DB~-25 Null Modem cable 
Keyboard Mouse/Keyboard | Connect directly to SPARCbook 2 
Mouse (mechanical or optical) Mouse/Keyboard | Connect directly to SPARCbook 2 or via the 
| mouse connector on the keyboard. 
SCSI Drive SCSI | Connect via SCSI breakout cable (supplied with 
| SPARCbook 2). 
External Modem Serial Connect using DIN-8 to DB-25 serial port to 


modem cable, wired as shown in the figure below.| 


Microphone Audio | Audio Cable (supplied with SPARCbook 2) 


Speakers Audio Audio Cable (supplied with SPARCbook 2) | 


Wiring for Serial Port to Modem Cable 


Receive 


Ready to Send 


Transmit 


~ Data Terminal Ready 
Signal Ground 


7— Data Carrier Detect 


DIN-8 PLUG \2__“"""**"" —\7~_DB-25 PLUG 
(Solder side) (Solder Side) 
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A range of quality accessories are available for your SPARCbook 2 system through your 
SPARCbook supplier. The list of accessories is being added to constantly. However, the table below 


provides a summary of some popular accessories available when this guide was published. 


DESCRI PTION 


ORDER CODE 
S2-STDMSE | Mechanical mouse 
| S2-OPTMSE | Optical mouse with mouse pad 
[sS2PC 0” | SofPC® SPARCbook 2 version DOS emulation 
§2-KBD ; ‘| Sun Type-5 keyboard (US layout) : : ; 
| §2-AUDKIT - | Audio kit: Battery-powered speakers and microphone 
| SB-BATT | Spare battery a : : 
SB-CHARGE 7 | External battery charger (works in conjunction with SB-EPS) 
| SB-X MON .. Ss ‘High resolution 17” color monitor 7 e : 
| SB-EPS_ * External power supply = 
SB-LOCK _ ~ | SPARCbook security lock - 
| SB-CASE | Deluxe SPARCbook carrying case : | 
SB-SCBL | Serial cable — DIN-8 to DB-25 7 = F 
| SB-10BS2 10base2 microtransceiver 7 _ 
| SB-10BST | 1O0baseT microtransceiver 
| SB-MDM96 | 9600 baud pocket modem ; 
SB-CA12 12V vehicle lighter socket adapter 
| SB-CA24 | 24V vehicle lighter socket adapter 
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DEVICE DRIVER INTERFACE AND UTILITIES 


The SPARCbook 2 I/O devices are accessed from the Solaris 1.0.1 Operating System by file 


operations on files in the /dev directory. The following table shows the corresponding device 


entry for each of the hardware devices used in the SPARCbook 2 notebook computer. Where 


possible the same device entry names and numbers are used as for a standard sun4m architecture 


hardware product. 


For further detailed programming information on the SPARCbook 2 I/O devices and 
peripherals please refer to the SPARCbook 2 Technical Reference manual available 


from your SPARCbook supplier. 


DEVICE NAME DESCRIPTION 
extms External mouse 
extkbd External keyboard 
het! hardware control 
modem Internal modem interface 
nrst8 No-rewind SCSI tape streamer device 
rsd[0-7][a-h] SCSI disk raw device interfaces 
rst8 SCSI streamer tape device 
sd[0-7}[a-h] SCSI disk block device interfaces 
srO SCSI CD-ROM 
serial RS232 serial interface 
ttya RS232 serial interface 
Frame buffer 
cuaQ Alternate device for ttya 
cual Alternate device for modem 
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DISK LAYOUT AND FILE SYSTEMS 


The hard disk drive used in the SPARCbook system is divided into areas or partitions for operating 
system use. The size of the partitions is set up automatically as part of the factory system 
configuration. However, it is possible to reconfigure the partitions to meet specific requirements. 
This section describes the default partitioning of the hard disk(s) and explains how to change the 


partition specifications. 


Internal Disks are sized in logical cylinders. A logical cylinder comprises 4 logical 


heads and 16 logical sectors per track. A logical sector stores 512 bytes of data. All 
partitions are sized in logical cylinders, corresponding to 32K bytes of data per 


cylinder. 


° Configuration 1 — Single Disk models 


By default, single disk models have the layout shown in the table below: 


PARTITION POSITION eae DEVICE DESCRIPTION 
+ = 
System 0 | - Partition Table 
519) i sd0b Swap space (16 Mbytes)* 
Swap ] 1024 sd0b Swap space (32 Mbytes) 
2056 sd0b Swap space (64 Mbytes) 
513 | 
Root 1025 remaining sd0a Root partition 
2057 
Whole 0 whole disk sd0c Whole disk 
end—512 512 Resume (16 Mbytes)? 
Resume end—1024 1024 sd0d Resume (32 Mbytes) 
end—2056 2056 Resume (64 Mbytes) 


a. There is one Swap partition on the disk, equivalent in size to the DRAM in the system. 
b. There is one Resume partition on the disk, equivalent in size to the DRAM in the system 
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The file system is tuned during installation with a minimum free space of 0%, and is optimized for 
space. 


° Configuration 2 — Dual Disk Models 


By default dual disk models have the same layout as a single drive model on Disk 0 and the layout 


shown in the table below for Disk 1: 


PARTITION POSITION ate DEVICE DESCRIPTION 
(Cylinders) 
=o + + 
System 0 1 - Partition tables 
opt I Remaining sdla /opt partition 
Whole 0 Whole disk sdic Whole disk 


CHANGING THE DISK LAYOUT 


For specific requirements you may change the disk layout to suit your own requirements. However, 
if you wish to change the layout of a partition that has existing user or system files resident, you will 


need to backup the relevant files before you change the partition information. 


If you change the partition information for a partition that has system and/or user files 
resident then those files will be lost. Ensure you have a full system backup before 


attempting to change partition information. 


To change a partition you can use the format command in the minifs file system, or in the 
operating system itself. You cannot modify a mounted partition. You must also observe the 


following constraints: 
sd0a Must be the root partition and must be at least 1760 Cylinders 


sd0b Must be the primary swap partition and must be at least 384 
Cylinders starting at Cylinder 1. 


sddc Must always be the whole disk 


sdic Must always be the whole disk 
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In addition a Save and Resume partition must be at least the size of the system physical memory. 
The Save and Resume facility will use the first 16, 32 or 64 Mbytes of this partition, if enabled, as 


discussed in the next section. 


If you do not conform to the above requirements the system may not be buildable. You 
should refer to ‘Disk Problems’ on page 274 if you have changed the partitions and are 


unable to load the operating system. 


The format program provides on-line help and is used to format and partition disks. The procedure 
below is an example of how to partition a second disk to provide two 28Mbyte partitions, an 
additional 32Mbytes of swap space, as well as the Save and Resume area. It also explains how to 


make file systems and how to mount and use the new partitions. 
. The format command 


Because the operation of formatting and partitioning a second disk does not involve the basic 
operating system you can carry it out on a running system. If you want to change the root file 
system layout you will have to reload the operating system using the minifs file system. Before 


continuing, make sure you have done the following: 
¢ Taken a system Backup 


¢ Unmounted the /opt partition (or else you cannot run format on it). To do this 


login as root and type: 


wv Cd. 7 
# umount /opt 


¢ Run the format command 


# format 


The format program will search for disks locally, and then via the SCSI interface. To partition the 


second disk select disk 1 to the Specific Disk question (disk sd1). 


¢ Choose Partition Information and then print the current partition table 


format> partition 
partition> print 
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As shipped, a second 250 Mbyte disk would have a table similar to the following: 


partition a - starting cyll, # blocks246976 
partition b - starting cyl0, # blocks0 
partition c - starting cyl0, # blocks247040 
partition d - starting cyl0, # blocks0 
partition e - starting cyl0, # blocks0 
partition f - starting cyl0, # blocks0 
partition g - starting cyl0, # blocks0 
partition h - starting cyl0, # blocks0 


Partition a is the /opt file system and c is the whole disk. 


Note that the printed table shows starting cylinder numbers, and the partition sizes in blocks. You 
will be asked to enter partition sizes in blocks. You should ensure that all start locations and sizes 


are on cylinder boundaries (multiples of 64 blocks). 


¢ Change the Partitions 


partition> a 

partition a - starting cyl 1, # blocks 181504 
Enter new starting cyl [1]: 1 

Enter new # blocks [181504]: 92160 
partition> b 

partition b - starting cyl 0, # blocks 0 
Enter new starting cyl [0]: 1441 

Enter new # blocks [0]: 92160 
partition> e 

partition e - starting cyl 0, # blocks 0 
Enter new starting cyl [0]: 2881 

Enter new # blocks [0]: 62656 


These commands create 3 new partitions of 45, 45 and 30Mbytes respectively. The revised partition 
table can be seen before actually writing it to the disk by using the Print command again. This 


time the revised partition table will be displayed. 
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partition> print 


partition a - starting cyl 1, # blocks 92160 
partition b - starting cyl 1441, # blocks 92160 
partition c - starting cyl 0, # blocks 247040 
partition d - starting cyl 0, # blocks 0 
partition e - starting cyl 2881, # blocks 62656 
partition f - starting cyl 0, # blocks 0 
partition g - starting cyl 0, # blocks 0 
partition h - starting cyl 0, # blocks 0 


The partition map is written to the disk by issuing the label command. 


partition> label 


The Jabel operation will write the new partition information to the hard disk. It will not be possible 


to recover the contents of old partitions once this operation is carried out. 


DISABLING SAVE AND RESUME 


The SPARCbook 2 system features a facility called Save and Resume. It is provided as part of the 
Nomadic Computing Environment to allow you to shut the system down while running 
applications, and restore it on the next power up to its exact state at the moment you turned the 
machine off. This removes the requirement to shut down and reboot the operating system every 
time you turn the machine on and off. To perform this operation, however, the system has to 
allocate an area of disk space to store the complete memory contents when the machine is powered 
down. To achieve maximum Restore speed, compression techniques are not used resulting in a save 
and resume requirement equal to the amount of memory space in the system. If you are prepared to 
forego the Save and Resume function this disk space may be allocated as additional swap space or 


user file space. 


In order to disable the Save and Resume feature you need to make the following changes to the 


System. First login to the system as root and then carry out the following command: 


# /usr/etc/install/disable_saveresume 


After execution of this command when you turn the SPARCbook off using the Alt-Esc-O keyboard 
sequence, the system will execute the halt command. When you restart the SPARCbook the Solaris 


Operating System will be booted. 
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The halt command will cause the immediate exit of any applications running and the | 
operating system to shut down. You should ensure that you have saved any work you 
©) are doing and shut down any applications before turning the system off. Failure to 


observe this warning can result in loss of data. 


You may then reuse the partition freed up (by default sd0d) by allocating it as additional swap space 


or as a user file system. The procedures for doing this have been outlined in the preceding pages. 


Whether or not Save and Resume are enabled you may also turn the system off or reboot (restart the 


operating system) from the command line interface. The following command options are provided. 


shutdown [time] time may be ‘now’ for an immediate shutdown, or +n, 
where n is a number of minutes. A warning is printed to any 
logged in users 5 minutes before the shutdown. The 
SPARCbook will be switched off. 


reboot Write any pending information to the disks, shut down and 


restart the operating system. 


reboot -- -s As reboot but restart the operating system in single user 
mode. You will need to use Ctrl-D at the single user # 


prompt to continue into the normal multi user mode. 


halt Write any pending information to the disks, and then stop 
the operating system and turn the SPARCbook off. 


ENABLING SAVE AND RESUME 


Before re-enabling Save and Resume, you first need to ensure that there is a partition allocated to 
the Save and Resume function. You should ensure that this partition is not present in the 
/etc/fstab file. The Save and Resume function will use an amount of space on the partition 
corresponding to the physical memory size. Thus the Save and Resume partition must be at least 
32768 blocks on a 16Mbyte system, 65536 blocks on a 32Mbyte system and 131072 blocks ona 
64Mbyte system. 


You re-enable the Save and Resume facility by executing the following command when logged in 


as the superuser. 
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# /usr/etc/install/enable_saveresume partition 


partition is the name of the Save and Resume partition (for example 


/dev/sdl1f). 


When you next turn your SPARCbook off using the Alt-Esc-O sequence, the system state will be 


saved, and the resume function will be automatically activated when you restart the SPARCbook. 


RECONFIGURING THE OS KERNEL 


The optional cluster on the full CD version of the SPARCbook Solaris Operating System provides a 
directory of object modules for reconfiguring and rebuilding the SPARCbook kernel. This directory 
is built and used in the same way as for a standard Sun kemel and you should refer to the full 


documentation package for further information. 


However, it is possible to configure the kernel max_users parameter from the bundled operating 
system. By default this is set to 8. The max_users parameter is not a maximum number of users, 
but refers to the amount of kernel resources allocated to handling processes, the network activity 
and the OpenWindows system. You will normally not want to change the default setting. However, 
the facility exists to change the number as follows: 

# /usr/etc/install/maxusers n 


will change the maxusers parameter to n, which must be between 2 and 64. To take effect you 
must exit all your applications and restart the operating system by typing reboot when logged in 


as the superuser. maxusers typed without an argument will report the current setting. 


CONTROLLING THE USER LED 


When the SPARCbook 2 system is shipped, the User LED located on the display panel housing is 


assigned as a “Caps Lock” indicator. It can also be illuminated at the command prompt by using: 
% led on 


It can be turned off with the command: 


% led off 


These commands can be used in shell scripts 
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The SPARCbook 2 product incorporates a complete SunOS Release 4.1.2 implementation, 
including PostScript support, enhanced networking and file system support, DOS Emulation 
support and many other capabilities. Available from your SPARCbook 2 supplier is documentation 
for the operating system and software provided with SPARCbook 2. This section provides a quick 


reference guide to the documentation available. 


SunSoft use Solaris 1.0.1 to describe the SunOS 4.1.2 with bundled SunView 1.8 and 
OpenWindows Version 2 products. The SPARCbook 2 version of Solaris 1.0.1 comprises SunOS 
4.1.2 and a bundled Open Windows Version 3 product. The SPARCbook version does not include 


SunView. 


SUNOS 4.1.2 Documentation 


This part of the documentation set is standard SunOS literature and manuals. There is a brief 


description given of each binder. 
. SunOS RELEASE AND INSTALL 


Much of the SunOS Release and Install manual is Sun system specific, but it includes sections on 
the Software clusters, new features in SunOS 4.1.2 and some general information on the operating 
system and available documentation. Note specifically that the SunInstall program is not supported 
on the SPARCbook and that you should follow the installation procedure given in this guide to load 
the bundled operating system onto the SPARCbook disk. 


. USERS GUIDES 


These are brief manuals written for the user with little or no UNIX experience. Getting Started is 
for those new to the Sun computing environment. Other guides supplied are Doing More with 


SunOS, Basic Troubleshooting and Customizing your Environment. 
° GLOBAL INDEX 


This binder provides a global index to the SunOS 4.1 facilities. It does not cover the OpenWindows 
product. 
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° SYSTEM AND NETWORK ADMINISTRATION 


This is the main manual for system administrators, but will be of interest to all UNIX users. It deals 
with software administration including backup and restore, disk maintenance, system accounting, 


security, networking and electronic mail service and advanced UNIX system administration. 
° SunOS REFERENCE MANUAL 


This is the traditional UNIX manual pages alphabetically arranged as an index of commands, 


functions and file formats. The three binders contain the following 8 sections: 


¢ User Commands 

¢ System Calls and Error Numbers 

¢ User-level Library Functions 

* Devices, Drivers, protocols and Network Interfaces 
¢ File Formats 

¢ Games and Demos 

¢ Public files, tables and TROFF macros 


¢ System maintenance and operations commands 
° SunOS DOCUMENTATION TOOLS 


This covers the UNIX editors, vi, ex, ed and sed. A section about documents formatting explains 
TROFF and macros for indexing, table formatting and equation setting. The use of NROFF and 


TROFF explains the text processing utilities. 
° PROGRAMMERS GUIDES 


This group of manuals describes programming in the Sun Environment for system and application 


level. It comprises the following documents: 


¢ C Programmers Guide 

e Assembly Language Reference Manual for SPARC 
« ARISC tutorial on SPARC 

¢ Porting Software to SPARC systems 


¢ Debugging Tools 
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. PROGRAMMERS OVERVIEW 


The System Services Overview contains details of internationalization, security features, 
networking and UNIX standards compatibility. Programming Utilities and Libraries provides an 


overview of the Sun environment, facilities, utilities and libraries for the applications programmer. 
. NETWORK PROGRAMMING GUIDE 


This manual provides an overview of NFS, pipes, sockets, network commands, the on-line database 


service (NIS) and the network managers and monitors. 
° WRITING DEVICE DRIVERS/STREAMS PROGRAMMING 


This document provides a guide to writing device drivers for SunOS 4.1 systems and provides 
detailed information on STREAMS programming including theory, the SunOS implementation, 


and an index of STREAMS functions and data structures. 


OpenWindows Version 3 Documentation 


This covers the OpenWindows Graphical User Interface (GUI) and the DeskSet Reference Tools. 
Documentation for novice users of the DeskSet environment through to detailed programming 


information on the X11/NeWS server and libraries is available. 


OPENWINDOWS VERSION 3 RELEASE MANUAL 


Describes the OpenWindows Version 3 release including a general overview, new features and 


limitations. 
° OPENWINDOWS VERSION 3 INSTALLATION AND START-UP GUIDE 


Describes how to install and start-up the OpenWindows software. This is of limited use for the 
SPARCbook implementation since the bundled release is pre-installed. However, the guide also 


contains useful information on the other OpenWindows clusters, and special environments. 
. OPENWINDOWS VERSION 3 DESKSET REFERENCE GUIDE 


Provides information on how to use the DeskSet tools consisting of: File Manager, Mail Tool, 
Calendar Manager, Text Editor, Print Tool, Tape Tool, Snapshot, Shell Tool, Command Tool, 


Console, Performance Meters, Clock, Calculator, Icon Editor and Binder. 
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OPENWINDOWS VERSION 3 USERS GUIDE 


Provides a user’s introduction to the DeskSet environment and information on customizing the 


environment as well as running non-DeskSet applications. 
° OPENWINDOWS VERSION 3 PROGRAMMERS GUIDE 


Provides an overview of programming for the OpenWindows environment including the 
X11/NeWS server and its components. Information on NeWS and X11 utilities, clients, font and 


color support is provided. 

° OPENWINDOWS VERSION 3 REFERENCE MANUAL 

This contains the OpenWindows Version 3 UNIX style Manual Pages 

° XVIEW 3.0 REFERENCE MANUAL: CONVERTING SUNVIEW APPLICATIONS 


This contains instructions on converting the older SunView applications to X View. It provides 


details of the X View toolkit architecture. 
° OLIT 3.0 WIDGET REFERENCE SET 


This contains the reference introduction to the OLIT Widget Set. The manual pages for the Widget 


Set are also available on-line on the CD version of the SPARCbook Solaris OS. 
° NeWS PROGRAMMERS GUIDE 


Provides information on the NeWS language, including events, classes, canvases, memory 


management, client-server interface, debugging and operators and types. 

. NeWS TOOLKIT REFERENCE MANUAL 

Provides reference information on the TNT programmers interface. 

° TOOLTALK 1.0 SETUP AND ADMINISTRATION GUIDE 

Provides information on ToolTalk setup and maintenance for System Administrators. 
° TOOLTALK 1.0 PROGRAMMERS GUIDE 


Describes the ToolTalk service and provides information on adding ToolTalk messaging 


capabilities to new or existing applications. 
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. OPENWINDOWS VERSION 3 DESKTOP INTEGRATION GUIDE 


Provides programmers with information on the technologies available for developing and 
integrating applications for the OpenWindows Version 3 environment. It is written for ISVs who 
have previous windowing experience and who wish to integrate their applications with other 
DeskTop facilities. This includes discussions on selections, drag and drop, the Classing Engine and 


ToolTalk services. 


Books and Other Documentation 


The following books are also supplied as part of the SPARCbook reference manual set. 
. OPEN LOOK MANUALS 


The OPEN LOOK Functional Specification and Application Style Guide provide a definition of the 
OPEN LOOK Graphical User Interface for Applications Developers. 


° POSTSCRIPT MANUAL SET 


The PostScript Red book is the Language Reference manual. The blue book is the Tutorial and 


Cookbook providing worked examples of using the PostScript language. 
. X WINDOW MANUAL SET 


This is the complete eight volume manual set published by O’Reilly & Associates for the X 
Window system. It provides a comprehensive user and programmer guide to the X Window 


graphics software implemented on SPARCbook as part of the X11/NeWS server. 
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TROUBLESHOOTING AND 
PROBLEMS 


This chapter provides information on troubleshooting problems that might arise using the 

SPARCbook. It gives information on how to use the system diagnostics, and some guidelines on 
what to do if you suspect hardware or software problems. It is primarily intended to allow you to 
diagnose the source of a problem and to enable you to determine whether you can take corrective 


action yourself, or whether you need to call on the assistance of Customer Support. 
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HARDWARE 


The SPARCbook system provides simple low level diagnostics that can be run to determine 
possible hardware problems in the system. While these diagnostics cannot cover all eventualities 


they provide a reasonable first line confidence test in the basic operation of the SPARCbook system. 


System Will Not Start Up 


If the system does not respond when you switch on there may be no power to the system. When the 
system is first turned on all the LED indicators to the left of the display except the disk indicator 


should be lit for a brief period and the system should sound a short beep. 


PROBLEM: NO STARTUP BEEP 


e If there is no Beep from the system check the following: 
Is the battery dead? To check this plug in the external adapter and try again. 


Is the adapter faulty? Observe the LED on the front of the adapter. If it does 
not light when the supply is connected the adapter could 


be faulty. 


If power is being supplied to the system and there is no response, there may be a major hardware 


fault and you should contact your supplier for assistance. 


PROBLEM: NO DISPLAY INITIALIZATION 


¢ If there is a Beep but the display does not initialize check the following: 


Is the battery exhausted? If the Red LED is continuously lit, the battery is 
discharged. You will need to recharge it using the 
external adapter. You may use the system while you do 
this. 


If the display has not initialized, there is probably a serious problem with the system. The system 
will try and communicate through the serial port if it cannot access the display. To check this, 


connect a serial ASCII terminal to the serial port (see ‘CONNECTING AN ASCU TERMINAL’ on 
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page 163) and configure the terminal for 9600 baud operation, 8 bits, no parity, no handshaking. 
Reset the SPARCbook and if any output appears on the terminal attempt to run the diagnostics as 
detailed below. Note that the input device will still be the SPARCbook keyboard. 


Running Diagnostics 


By default the SPARCbook 2 system runs a set of fast diagnostics at power up. The results of these 
are reported on the system screen. You may also run more extensive diagnostics manually. To do 
this interrupt the start-up by pressing a key when the message “Press any key ...” is displayed. A 


menu will be displayed. Select ‘System Diagnostics’. A diagnostics menu will be displayed: 


SPARCbook Diagnostics 
System Configuration: 


Serial No: 21002 

64Mb DRAM 

16Mb at 0x00000000 

16Mb at 0x02000000 

16Mb at 0x08000000 

16Mb at 0x0a000000 

FPU present 

Hardware Revision Level: 1.1 
Firmware Revision Level: 2.17 
Palette Revision Level : 10 


DVC Revision Level ey 
MPC Revision Level : 0 
1> CPU 


2> Floating Point Unit 
3> Memory Management Unit 
4> System Controller 

5> Serial Controller 

6>  DMA/Video Controller 
7> Microcontroller 

8> Memory 

9> Modem 

10> Palette 

11> Ethernet 

12> SCSI 

13> CIO 

14> Full System Test 

15> Configure Diagnostics 


Enter Choice> 
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The system configuration and hardware revision level will be printed first and will vary according 
to your own system. You may then select a particular test to run. If any tests fail it is indicative of a 
hardware failure and you should contact your supplier for assistance. Using the ‘Full System test’ 


option, it is possible to run continuous diagnostics until you press any key to exit. 


While turning parity protection off can provide a small increase in performance it is 


not recommended except for diagnostic purposes, since it reduces the hardware system 


error detection capabilities of the SPARCbook 2. 


Disk Problems 


If the hard disk experiences a shock during operation or has a media flaw, it is possible that hard 
data errors can appear over the course of time. The Solaris Operating System will detect faults and 
report an error. The SPARCbook 2 system automatically remaps bad blocks so that they are 
replaced with an alternative good block. If the Solaris Operating System detects a bad block during 


normal use, it will report a message similar to the following 


Bad Block on Device 0 Block 135412 
Hard Disk error 


If a bad block occurs in a strategic location on the disk, such as one used by the operating system 


itself, the operating system may be unable to continue and may panic. 


ee A Solaris panic is a situation where the operating system is unable to continue due to a 
(NOTE 

: serious hardware or internal software error. The operating system will immediately 
abort or panic in order not to cause further data corruption. It will attempt to print 
information about the situation, which should be recorded for subsequent examination 


of the problem. See ‘Operating System Panic’ for further information. 


If the operating system is able to recover it will not panic, but will save any system information that 


does not depend on the faulty block to the disk and then automatically reboot. 


Repairing a Bad Block 


The disk drives used in the SPARCbook will automatically reassign defective disk sectors wherever 
possible. Occasionally, however, the disk drive may be unable to carry out the reassignment, in 


which case it may be possible repair the bad disk blocks interactively. If an unrecoverable disk error 
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occurs the SPARCbook 2 will, if possible, report the error and prompt you to restart the system. You 
should reset the SPARCbook using the Ctrl-Alt-R key sequence. When the monitor starts up it will 


enter a menu offering the choice of attempting to fix the problem or continuing. 


SPARCbook: Warning - Disk Errors have been found.?Disk 
errors should be repaired before the system is 
restarted, although this may result in a loss of data. 
Refer to the SPARCbook User Guide for further 
information. 


1> Repair Disk Errors 
2> Continue with automatic system startup 


Enter choice> 
If you select option 1, the monitor will again attempt to read the disk block that previously failed. If 


this works a message of following form will be printed: 


Repairing block 12345 on Drive 0 
The monitor has successfully read this block 


1> Allocate a new block 
2> Do not repair this block 


Enter Choice> 


If you select 1, the system will allocate a new block. You should take this action if the same disk 
bad block is persistently reported as being defective, even if the monitor is able to read the block. If 


this is an isolated incident you may select 2 and not reallocate the block. 


Disk Scanning 


The Solaris Operating System provides utilities for disk formatting and maintenance. This utility 
provides a menu which contains options to check the hard disks. A disk scan on the hard disk(s) in 
the system is nondestructive and can be used to verify whether a hard disk has blocks which cause 


hard unrecoverable read errors. 


275 


HARDWARE 


Other Hardware Problems 
PROBLEM: NO EXTERNAL DISPLAY 


The external display interface is normally disabled to conserve power while the system is running. 
To turn on an external monitor, you should ensure that the external display is connected correctly 
and is enabled via the External Display menu in the Workspace Portable menu. The monitor should 


be one of the type listed in this menu. 


To start up the external display interface from the Solaris command prompt you should use the 
command fbconfig. Refer to ‘CONNECTING AN EXTERNAL DISPLAY’ on page 151 for 


further information. 
PROBLEM: EXTERNAL MOUSE DOES NOT WORK 
PROBLEM: EXTERNAL KEYBOARD DOES NOT WORK 


The external mouse and keyboard must be compatible types and connected to the combined 
Keyboard and Mouse port using a Sun compatible keyboard and mouse cable. To check if the 
keyboard and SPARCbook 2 are communicating, try the command kbconfig -r, which should 
cause the keyboard LEDs to light. In the case of an optical mouse you can see if it is powered by 


checking to see if the red LED on its underside is illuminated. 
PROBLEM: SERIAL PORT DOES NOT WORK 


By default, the serial port is disabled to conserve power. It is enabled automatically by the operating 
system when the device is opened. The serial port is normally configured for printer application. If 
you wish to connect a login device to the serial port you will need to edit the file /etc/ttytab. 
Refer to ‘CONNECTING AN ASCII TERMINAL’ on page 163 for further information. 


¢ If the serial port still does not appear to work check the following: 


Is the cable wired correctly? The simplest wiring connects only Transmit Data, 
Receive Data and Ground. It is very easy to get pins 2 
and 3 the wrong way round for Data Terminal 
Equipment (DTE) or Data Communications Equipment 
(DCE). 
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PROBLEM: ETHERNET DOES NOT OPERATE 


Read the section ‘CONNECTING TO THE NETWORK’ on page 189 of carefully. Networking 
must be enabled before the network will run. If you suspect the Ethernet hardware run the 
diagnostics. If these seem fine then try using the monitor to load a file from a remote system using 
the beginning of the Stand-alone Restore facility. Refer to ‘Restoring the minifs over Ethernet’ on 
page 219 for further information. If this works then it is likely to be a software configuration 
problem. See ‘NETWORKING PROBLEMS’ below. 


When it is not in use, the SPARCbook 2 system software turns the Ethernet interface off in order to 
save power. You can force the interface to re-examine the connection to the network using the 


command ifconfig niO up. 


SOFTWARE PROBLEMS 


Since the operating system controls the peripherals, the operating system configuration is a critical 
component in enabling the SPARCbook to operate correctly. For example, a minor change in a 
networking configuration file can prevent the entire network interface from operating. On a UNIX 
system, the role of a system administrator is to resolve day to day operational problems with the 
operating system, to ensure the smooth running of a particular installation. The SPARCbook is a 
portable system and special efforts have been made to make operating system administration as 
easy as possible. Nevertheless, situations may arise where you need the help of an experienced 


system administrator or the SPARCbook technical support services. 


This section provides some information on common software problems and gives brief advice as to 


the course of action to be taken in each case. By its very nature it cannot be complete. 


Stopping Processes 


You can stop a process that is using keyboard input in most cases by sending the interrupt character 
to it. By default, this is the Ctrl-C key sequence. This will normally cause a program to exit. 
However, in some cases the program will not recognize or act on the interrupt character and you 
will need to kill the process in order to halt it (this is described in the next section). The 


OpenWindows X11/NeWS server also has a special character sequence to cause it to abort. 
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Aborting the X11/NeWS server will also kill any programs that are running on the OpenWindows 
screen. This should only be used as a last resort if you do not get any response from the system 


while running OpenWindows. 
To kill the X11/NeWS server type Alt-F1-Del. 


In extreme cases the system can completely hang. This indicates an operating system fault and is 
extremely rare. However, there are situations where programs run out of memory and are unable to 
recover, when unforeseen circumstances can occur. In this case there is little option but to reset the 
machine. See ‘Resetting the SPARCbook’ below for further information. The ‘MEMORY USAGE 
AND SWAP SPACE’ sections below may also be relevant. 


Killing a Program 


To see what processes or programs are running you should open a command tool or be at the 


normal UNIX shell prompt. The following commands will give a summary of the running 


processes: 
% ps gives a summary of your own processes 
% ps -a gives a summary of all user processes 
$ ps -ax gives a summary of all system and user processes 


This information can be used to kill processes that have hung or that do not respond to the interrupt 
command. To kill a process you need to record its process number from the ps command output. 


For example the following output shows a program called demo running: 


$ ps 

PLD TTY TIME COMD 
678 p2 0.00 sh 
713 ‘p2 0.05 sh 
tS. (pz 0.32 demo 
728 pz 0.01 ps 

% 


The Process identification number, or PID, is the number on the left side of the screen. So to kill the 


demo process you would type: 


% kill -9 718 
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The -9 specifies that the process should be killed regardless of what it is doing. If you do not own 
the process you will need to assume the root privileges to carry out this step. To do this you need to 
execute the su command first and enter the root password. When you have finished type Ctrl-D to 


exit the su shell and return to your normal user privileges. 


Operating System Panic 


If there is a hardware or a software fault the operating system may panic. This occurs when the 
operating system decides that it cannot continue to run the machine. If the system does panic a 
message will be printed on the screen saying so, together with as much information as the operating 
system is able to gather about the cause. You should record the information for subsequent use by 
SPARCbook Technical Support. The system may be able to reboot automatically or may require 


manual resetting as described below. 


Resetting the SPARCbook 


If the operating system has panicked or all other remedies have failed, you will have to reset the 
SPARCbook. This should only be used as a last resort since the operating system will have open 
files and unflushed buffers and will have to be repaired when the system is rebooted. To reset the 


system press Alt-Esc-R simultaneously. 


You should only press Alt-Ese-R when you want to reset the system. If you perform 
this operation during normal system use, the file system will be corrupted and will 
require repairing. You may also lose files that you were working on at the time. In an 


extreme case you may need to rebuild the file system on the disk. 


After a reset, the SPARCbook will attempt to reboot in the normal way and will carry out a 
complete Solaris reboot (which differs from a Resume operation). However, following a Reset, an 
automatic file system check program (fsck) will be run. In most cases this will complete 
automatically. However, in some instances it may require manual intervention to repair the file 


system. A typical example of this is shown below: 
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checking root file system 

/dev/rsd0a: UNREF FILE I=17481 OWNER=user MODE=100755 
/dev/rsd0a: SIZE=0 MTIME=Jan 3 12:27 1992 (CLEARED) 
/dev/rsd0a: SUMMARY INFORMATION BAD (SALVAGED) 
/dev/rsd0a: 3992 files, 57802 used, 8229 free 
/dev/rsd0a: (53 frags, 1022 blocks, 0.1% fragmentation) 
Mounted FS Fixed - rebooting Single User 


Alternatively you may be asked to start £sck by the system itself. 


Enter the root password to gain access to the system maintenance facilities. Note that you cannot 


use OpenWindows or the network facilities at this stage. Run the fsck program as follows: 


# fsck /dev/sd0a 


You may be asked questions as the file system check proceeds. Typically, any files removed are 
temporary files, files with duplicate references or null files. You may be asked whether to Reconnect 
a file. This means that a file has been found but the system has lost track of its name. It will be 
stored in the directory / lost+found with a unique number. Such files may be examined and 
recovered after the system has been completely rebooted. If the file is specified as having zero 
characters it is empty and you should answer ‘no’ to the ‘reconnect’ question and ‘yes’ to the 
‘clear’ question. You should typically answer ‘yes’ to the questions posed as the system will try and 
do the best job it can at repairing the file system. However, in rare cases critical system files can get 
corrupted and answering ‘yes’ can mean that the system cannot be rebooted and must be 
completely restored from a backup. In this event you may be able to save some of your data before 
you rebuild the system. The data will have to be saved from the single user environment. If you 
have not used the £sck program before and you are unsure how to proceed you will need to ask for 


help or technical support. 


After completion of the fsck the system will either automatically reboot, or may complete its 
single user start-up sequence and give the # prompt. In the latter case simply type Ctrl-D to 


continue the normal boot sequence. 
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Failing Program 


Programs can fail to run for a variety of reasons. Some of these are described below: 
PROBLEM: PROGRAM FAILS 


A segmentation fault or core dump error message is due to the operating system encountering an 


unrecoverable error during program execution. Possible causes are: 
¢ Corrupt program — the disk copy of the program has been corrupted 


¢ Shared Library inconsistency — the program was compiled with a shared library that 
is incompatible with the SPARCbook version. You may use the Idd utility to 


determine what libraries a program is loading: 
% ldd /usr/bin/1s 


dynamic linker: /usr/bin/ls: file loaded: /usr/lib/libw.so.1 
dynamic linker: /usr/bin/ls: file loaded: /usr/lib libintl.so.1 
dynamic linker: /usr/bin/ls: file loaded: /usr/lib/libc.so.1 
dynamic linker: /usr/bin/ls: file loaded: /usr/lib/libdl.so.1 


% 


This problem can only be resolved by relinking the application with the SPARCbook or SunOS 


shared libraries. 


¢ Program Error —a programming fault can cause a segmentation violation if, for 


example, a program attempts to write to an illegal or protected address. 


¢ Out of Swap Space or Memory Space — a message may sometimes be printed on the 
console if either of these conditions occur. If you are running OpenWindows the 
server may suddenly exit, returning you into the terminal interface. See ‘Memory 


Usage and Swap Space’ below for how to prevent this problem. 


* Memory failure — there has been a memory error (hardware) during program 


execution 
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The bundled SPARCbook Operating System includes the trace utility which allows you to monitor 
the system calls made by a process. This can sometimes help an experienced UNIX programmer 
track down the cause of a problem. In addition experienced UNIX programmers may be able to use 


the crash, adb or dbx debugger utilities provided to determine the cause of a core dump. 


If a segmentation violation or core dump message is printed and you are not going to 


examine the core file with a debugger it is sensible to remove the core file. Core files 


O<Q 


each consume many megabytes of disk space. 


WARNING MESSAGES 


The Solaris Operating System will often print warning messages as system information. There is 
nothing necessarily wrong, but you need to understand which messages are an indication of a 


potential problem and which are simply for information. 


Warning messages are generally displayed in the Console window, but may also be displayed in a 
cmdtool window or in the application window you are using. The following is an example of an 
information message on the console, meaning that someone with the account user has 


successfully performed an su command, and now has superuser access privileges. 


Jan 12 19:43:16 su: ‘su root’ succeeded for user on /dev/ttyp2 


The following messages are also generally not an indication of any problem. 


XIO: fatal I/O error 32 (Broken pipe) on X server “:0.0” 
after 1068 requests (1068 known processed) with 0 
events remaining 
The connection was probably broken by a server shutdown 
or KillClient 

This message indicates that the X11 server was told to kill a process when it still had outstanding 
events to write to a window. It is usually as a result of quitting a demonstration or an X11 program 


using the Window Quit option. 


XView warning: Notifier error: Unknown client 


You may see messages such as this when you exit from the X11/NeWS server. They are not an 


indication of any abnormal behavior. 
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Some messages are an indication that the system has run out of resources and require attention. For 


example, a program may fail to start or may print a message such as: 


out of swap space 

or out of memory 

or FS full on /dev/sd0a: cannot write %xyx 
As a general guide you should try and exit the offending program in this situation. It is prudent to 
reboot the operating system after such an event since applications and the operating system do not 
always recover from resource failures gracefully. (Running out of space on the floppy disk or on 
attached media is not an abnormal event and simply requires you to take the appropriate action). If 
you run out of disk space you must either move files to a different file system, or to a networked 
server, or you must remove them. Overcoming swap space and memory limitations is discussed in 


the next section. 


MEMORY USAGE AND SWAP SPACE 


The Solaris operating system uses Virtual Memory. This allows several programs to be running at 
any one time even though they will not all fit into the available memory. Parts of a program that are 
not running at a given moment can be swapped to a special area on the hard disk drive called the 
‘swap space’. However, all applications require a certain amount of memory to be available before 
they will start up. The memory provided in the SPARCbook 2 can be used up if you start up many 
applications and leave them all on the OpenWindows workspace. Programs which have been closed 


to icons, for example, still run and may be using significant amounts of memory. 


In addition, instead of running out of memory, you may have too many applications runing to fit 
into the available memory and swap space allocated for the system. The default system has 16M 
bytes of swap space allocated. You can find out how much of this you are using at any time with the 


pstat command. This will print out the amount swap space available and in use. 
# pstat -s Print swap space statistics 
The strategies below show how to minimize your memory and swap space requirements. 


The system has been configured to allow a reasonable number of tools and applications to be used 
simultaneously. Typically a user might be running one or two third party applications, together with 


a Mail Tool, a clock and a File Manager. Depending on the size of the applications this should not 
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present any difficulties. However, if you attempt to run a large number of complex applications on 


the SPARCbook sooner or later you are likely to run out of memory or swap space. 


To minimize your memory and swap usage bear the following points in mind: 


¢ Minimize the number of DeskSet tools you use. The tools use large amounts of 
memory. For example, if you only use the Calendar Manager occasionally, call it up 
from the Workspace menu when you need it rather than leaving it as an icon on your 


workspace. 


¢ Avoid using tools that use memory continuously or often. For example the 
performance meter tool runs every second. Similarly, if you enable the second hand 


on the clock the clock program must run every second. 


¢ Keep your mail in mailfiles if you have more than tens of messages. Each message 


that appears when you open your mail file takes memory. 


¢ Keep tools iconified if you are not using them, but do not want to quit them. For 
example, the performance meter and the File Manager tools are suspended when they 


are iconified, freeing up memory (but not swap space) for other processes. 


¢ Arrange tools on the screen so they do not overlap. This reduces repainting by the 


Window Manager. 


e If you are using the multi-browser in the Calendar Manager, quit it when you are 
finished rather than iconizing it, it is almost as quick to restart it from the Calendar 


Manager as it is to open it from the icon. 


¢ Do not use a background image for the main background, plain backgrounds use less 


memory. 
¢ Avoid using PostScript applications at the same time as OpenLook applications. 


¢ Do not try and run too many applications at once. You may have to reduce the 
number of different applications active or on the DeskTop if you want to run a new 


large application. 
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Adding Swap Space 


You may add swap space to your system in one of two ways. The first has already been described in 
the Technical Reference section and involves allocating a disk partition as further swap space. This 
could be a new partition if you have the space available, or could be achieved by using the Save and 
Resume partition (in which case you will lose the Save and Resume functionality). Alternatively 
you may designate a normal file as additional swap space for the system. For example the following 
commands will create a 6Mbyte file for use as extra swap space (you will need to be superuser or 


logged in as root to do this). 


# mkdir /swap 
# cd /swap 
# mkfile 6m SWAPFILE Make a 6Mbyte file 


To add a swap file or an unused disk partition to the system you should add lines such as the 
following to the file /etc/fstab. 


/swap/SWAPFILE swap swap rw 0 0 _ foraswap file 
or /dev/sdld swap swap rw 0 0 to add the sdld partition 
Finally, tell the system that the additional swap space is to be allocated by executing the swapon 
command. This will add the newly created swap partition. When the operating system restarts it 


will automatically set the additional swap area up so you only need to do this once. 
# swapon -a 


If you allocate a partition for swap space all existing data on it will be removed. Refer 


to ‘DISK LAYOUT AND FILE SYSTEMS’ on page 258 for further information. 


NETWORKING PROBLEMS 


The Solaris 1.0.1 Networking facilities depend on system wide configuration and setup. If you are 
unable to communicate over the network you should ask for help from an experienced UNIX 
system administrator. If such a person is not available you should carefully go through the 
procedures outlined in ‘Configuring the Network’ to check the system setup. The most common 


problems are outlined below: 
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¢ Hardware Problems Faulty transceiver 
Faulty transceiver cable 
Bad connection to Ethernet cable 


Unterminated Ethernet cable 


¢ Software Problems Entry for remote system not in /etc/hosts (not NIS) 
Entry for your system not in remote hosts (not NIS) 
NIS Database not remade after your host entered (NIS) 
Ethernet Addresses incorrect or duplicate 
No write permission to requested resources 


Cannot find name server (NIS) 


A quick way of determining whether basic Ethernet communication is set up correctly between 
machines is to use the ping command. This command checks whether low level packets can be 


sent and received. To use it specify: 
$ ping systemname 


Where systemname is the name of the machine you wish to communicate with. 
If the communications path is operating a message will be returned: 


systemname is alive 


If there is a hardware or a configuration problem nothing will happen as the transmitted packets are 
not being returned. The command will time-out, but you may terminate it with the Ctrl-C interrupt 
command. If ping fails there is a basic hardware or software configuration problem and you 


should check the hardware interfaces and the basic software setup. 


GETTING FURTHER HELP 


If you are unable to diagnose the problem yourself you should obtain technical support from a 
UNIX administrator or from your SPARCbook supplier. Be ready to provide the following 


information to assist in determining the cause of the problem: 


Machine Model Number and Serial Number (from base of unit) 

Machine configuration (what peripherals are connected) 

For networking problems a brief description of your network will be helpful 
A description of the problem and any steps you have taken to overcome it 


Any warning messages or Panic Message output you have observed 
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SOLARIS 1.0.1 BUNDLED 
COMMAND SUMMARY 


SPARCbook Version B 
for OpenWindows V3 applications 


This summary provides a short guide to the commands available in the SPARCbook version of the 
Solaris 1.0.1 Operating System. It is intended for a quick reference only and is not complete. For 
further information on these commands you will need to refer to the documentation outlined in 
‘FURTHER READING’ on page 265. 


Each command is printed in the following form: 


command [options] arguments (ref) 
description 


Ref is OWV3 Available in OpenWindows only 
SYSV Available in /usr/5bin 


For some commands, only the most commonly used options are listed. There may be other options 
available that are not summarized here. Where a command is available both in the UCB and SYSV 
trees the UCB version is summarized. In addition, some internal administration commands are not 
included. Note that not all commands are supported for all devices, and some command options are 


hardware dependent. 


This summary is for reference purposes only and is intended to to provide an aide- 


memoire for users familiar with the UNIX command structure. It provides only a 
single line explanation of the use of each command and is not intended as an 


exhaustive reference. 
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a2ps 
formats a text file as postscript 


-b Force printing of binary files 

-c Cut lines too large to be printed inside the borders. 
-f num Changes font size to this value 

-h Don't print headers. 


-i Interpret TAB, BS and FF characters 
Set TAB width to num (default 8). 
Nv Make non-printing characters visible 


ac [options] 
login accounting 


-w wimp alternate wtmp file 
-p print individual totals 
-d each 24 hour period 
acctcms 
command summary from per-process accounting records 
-a print in ASCII not internal format 
-c sort by CPU time 
| combine all commands invoked once 
-n sort by number of processes 
-S files in internal format 
a“ process as total accounting records 
-p prime time only 
-0 non-prime time only 
acctprecl 
acctprc2 


process accounting 


adb [options] [object [core] ] 
general purpose debugger 


-w open object and core for writing 
-k kernel memory mapping, for /dev/mem 
-| dir dir to seek command files (/usr/lib/adb) 


adbgen file.adb 
generate adb script 


addbib [options] [database] 
create or extend a bibliographic database 
-a do not prompt for an abstract 
-p file use a new prompting skeleton from file 


add_clusters 
provides software installation services 


add_user uname uid gid name homedir shell 
add a user account to the system 


apropos 
locate commands by man page lookup 


ar options afile [names] 
maintain portable archive or library 


d delete named files from afile 

r replace named files 

ru replace named files if newer 

t[alb] posname __ replace after|before file posname 

q append quickly to end of file 

t print table of contents 

p print named files 

m{[alb] posname] move to end or after|before posname 

x extract names (or all) 

v verbose 

c do not print create message 
arch [-k] 


display architecture of host - returns sun4 
-k display kernel architecture - returns sun4m 


arp 
address resolution display and control 
-a Display all of the current ARP entries 
-d Delete an entry for the host called hostname 
-S Create an ARP entry for the host 
-f Read the file named filename 


as [options] file 


assembler 
-0 Objfile output to objfile 
-L save defined labels beginning with L 
-R make initialized data read only 
-On enable peephole optimization level n 
-P run cpp on each input file 
pass -Ipath, -Dname, -Dname=def, -Uname 
-S[C] pass disassembly of emitted code to stdout 


C prevents comment lines 


at [options] time[date] 
execute commands at a later time 


[+ inc] [script] 


-c use csh to execute script 

-S use sh, default is to use SHELL env var 

-m send mail after job completes 

-| [job] reports all jobs scheduled for user, or specified jobs 

-r job unschedules previously scheduled jobs 

time not used for -l and -r, hhmm or hh:mm or now 
(requires + inc) 

date Monday-Friday, or Jan-Dec 1-31 

+ inc +n minutes/days/weeks/manths/years 

script command or script to execute 
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atq [options] 
display jobs queued to run at specified times 
-c display jobs in order they were created 
-n display only the current total number of jobs 


atrm [options] arg 
remove jobs queued by at or batch 


arg user name or job number (see atg for list) 
all. If invoked as root all jobs will be flushed 
-f force - ignore any messages 


-i interactive - answer y to remove each job 


awk [-Fc] [prog] [params] [files] 
pattern processing language 
-Fe Separate fields by character c (default white space) 


prog Specified patterns 
params Parameters of form x=..., y=... 
files Input file(s) 


banner strings 
prints up to 10 characters in large letters (SYSV) 


bar [options] 
create tape archives, and add or extract files 
c create new file 
r write named files to end (not 1/4” cartridge) 
x extract 
t list contents 
u add if not there or modified (not 1/4” cartridge) 
specity dev/rmtx, default is 8 
use next argument as bar-file 
exit if error 
suppress owner and mode info 
verbose 
wait for user confirmation (y) 
blocking factor (default 20) 
use next argument as file of exclusions 
error if all links not resolved 
exclude SCCS directories 
exclude SCCS, .o, errs, core and a.out files 
do not use file modification time 
follow symbolic links 
restore to original modes 
perform multiple reads to fill block 
ignore directory checksum errors 
force group/owner to be as bar process 
string up to 128 chars for volume header ID 
dir target directory for extraction 
user ID in volume header 
compress/decompress 
read and print volume header 
check user owns media 
terminate media search after specified files found 
use next argument as file of files 
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basename string [suffix] 
deliver portion of a pathname 


battery 
give information about the battery charge level 


bc [options] [file] 
arbitrary precision arithmetic language 
-c compile only 
-l provide arbitrary precision math library 


biff [y|n] 
give notice of incoming mail 
y allow notification 
n disable notification 


bitmap file WxH 
bitmap editor for X (OWV3) 


bmtoa,atobm file 
bitmap converters to and from ASCII (OWV3) 


WxH width and height in pixels 
help print available options 
bldrgb 


build a colormap database (OWV3) 


cal [[month] year] 

print calendar for current or specified month/year 
1-12 
1-9999 


month 
year 


calctool [options] 
a desktop calculator (OWV3) 


-[2|3] 2 is 2D look, 3 is 3D look (default) 

-a num display num digits after decimal point 
-| start up a left handed version 

-m monochrome 

-V print version number 

-Wn/+Wn do not/do print titleline 


calendar [-] 
reminder service 
Perform for all users who have calendar file in their 
home directory 


captoinfo [options] 
convert a termcap description to a terminfo entry 


Vv verbose 

-V print version 

-1 print fields one per line 

-w width change output to width characters 
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cat [options] files 


concatenate and 
-b 


cb [options 


print files 

number lines, except for blank lines 
number lines 

do not buffer output 

substitute single blank line for multiple lines 
print non-printable characters visibly 


as -v and print tabs as “| and formfeed as “L-eas -v 


and print $ at end of each line 


] [file] 


simple C program beautifier 


=] 
-s 
-lleng 


cc [options 
C compiler 
-a 
-align _block 


-Bbinding 
-Cc 

-C 

-dalign 
-dryrun 
-Dname[=def] 
-E 

-fsingle 

9 

-go 

-help 
-lpathname 
-llibrary 
-Ldir 

-M 
-misalign 
-0 file 
-Olevel 


-P 
-pic 

-PIC 

-pipe 
-Qoption po 
-Qpath name 
-Qproduce t 
-R 

-S 

-temp=dir 
-time 
-Uname 

-W 


join split lines 
standard C style 
split lines longer than leng 


] 


insert code to count basic blocks 


force global uninit data symbol block to be page 


aligned 

binding is static|dynamic 

do not link, produce .o 

do not remove comments with cpp 
generate double load/stores 

show commands but do not execute 
define name to cpp 

run through cpp only 

use single precision FP 

produce output for dbx and dbxtool 
produce output for adb also 

info 

Include files 

link with library 

directory for library search 

run macro preprocessor only 

allow load and store of misaligned data 
output file 

1 postpass assembly level optimization only 
2 global optimzation (default) 

3 optimize use and definition of externals 
4 trace effects of pointer assignments 
run cpp only 

position independant code 

as -pic but with 32 bit addresses 

use pipes not intermediate files 

pass option o to program p (as|cpplinline|!d) 
add name to compilation search path 
tis .c|.i|.o|.s 

merge data with text for as 

produce assembly file only 

dir for temporary files 

report execution times 

undefine name to cpp 

do not print warnings 


ed [directory] 
change working directory 


directory new directory - default is home directory 


cdplayer 
CD-ROM audio demo program 
-d device Use device as the CD-ROM device 


checknr [options] [files] 
check nroff and troff input files; report possible errors 


-f ignore \f font changes 
-S ignore \s size changes 
BK YT aes add pairs of macros 


“O.X1 wae define commands otherwise undefined 


chgrp [options] group file 
change the group ownership of a file 


-R Recursively descend down stated directory 
-f force - do not report errors 
chkey 


change user encryption key 


chmod [options]|[mode] file 
change mode of a file 
options ulglo|a +|-|= r|w|x|s|t}X eg a+x 
u user, g group, o other, a all, 
+ add,,- take away, = assign absolute 
r read, w write, x execute, s user or group set-ID, 
t sticky, X execute if directory 
mode OR of: 
4000 set user ID 
2000 set Group ID 
1000 set sticky bit 
0400 read by Owner 
0200 write by Owner 
0100 execute by owner 
0070 allow read/write/execute by group 
0007 allow read/write/execute by others 
e.g 755 is rwx for owner, rx for all others 


chown [options] owner file 
change the owner of a file 
-R recursively descend down stated directory 
-f do not report errors 


chroot newroot command 
change root directory for a command 


chrtbl [file] 
generate character classification table 


clear 
clear the terminal screen or cmdtool window 


click [-y|-n] 
enable or disable keyboard click 
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clock [options] 
display time in a window (OWV3) 


-Wn/+Wn use/do not use titleline 

-D debugging 

-T test mode 

-24 use 24 hour mode if digital clock 


-analog/digital use analog/digital clock 


+/-date do/do not show date 

a use roman numerals in icon 
+/-seconds show/do not show seconds 
~v show version number 

-TZ timezone start with different timezone 
-alarm setting setting is none|once|daily 


-alarmtime hh:mm alarm time 
-alarmemd cmd 


-houremd cmd 


command to run on alarm 
command to run every hour on the hour 


cm (xview options) 
cm_delete [options] 


cm_lookup [options] 
calendar manager, appointment and resource scheduling 
delete appointments from Calendar Manager database 
look up appointments from Calendar Manager database (OWV3) 
-c calendar 
-d date 
-v view 


name of calendar, default is your own 
date in format mm/dd/yy 
view is day|week|month 


cm_insert [options] 
insert appointments into Calendar Manager database (OWV3) 


options as for cm_delete 

-s start start time hh:mm 

-e end end time 

-w what up to 5 lines description (use “\n’) 


cmap_alloc [options] 
allocate default colormaps for non-default visuals (OWV3) 
-display display:n.screen 
which X11 server to use, default is DISPLAY 


-force create a colormap even if one already 
-allscreens create for all screens on a display 
-depth n create for those visuals with depth n 
-visual class create for those visuals with class class 
-verbose print diagnostics 

-help usage 


cmap compact 
colormap configuration to reduce colormap flashing (OWV3) 


cmdtool [options][xview options] 
run a shell in an OpenWindows terminal window (OWV3) 
-C console cmdtool 


-M num set log to wrap after num bytes 

-P count checkpoint log after every count editing ops 
-B style set style for bold text 

-| command pass command to shell (escape spaces) 


xview options see xview 


cmp [options] filel file2 
compare two files 
-| print the byte number (decimal) and differing bytes 
(octal) for every difference (default first) 
-S print nothing - just return codes 


col [options] 
filter reverse line feeds 


-b output device cannot backspace 

-f fine — allow half line motions 

-h convert white space to tabs where possible 
-p pass escape sequences 


colcrt [options] 
filter nroff output for terminal with no overstrike 
* suppress all underlining 
-2 print all half linefeeds 


colortool 
manipulate the current color palette mappings 


colrm startcol [endcol] 
remove characters from specifed columns 


comm [options] filel file2 
select or reject lines common to two sorted files 
-[1)2][3] 1 


2 donot print lines only in file2 


do not print lines only in file1 


3 donot print lines common to both files 


compress [options] files 
uncompress [-cv] files compress/uncompress file(s) 


-c write to standard output 

-f force compression (default not to if no help) 
~v display % compression for each file 

-b bits bits is 9-16, default 16 


cp [options] files target 


copy files 

“i prompt for confirmation if overwriting 
-p preserve modification time and mode 
=f recursive copy for directories 


cpio [options] 
copy file archives in and out 
-i [b>BcdfmrsStuv6] [pattern] 
copy in 
-o [aBcv]} copy out 
-p [adlmuv] directory 
copy across 


-a reset access times after copy 
-b reverse order of bytes and half words 
-B block 5120 bytes to record, default 512 
-c read or write headers in ASCII form 

— required to transfer devices 
-d create directories as needed 
-f copy in all files except patterns 
-l cpio -p only, link files where possible 
-m retain file modification time 
-s swap bytes within each half-word 
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-S swap half-words within each word 


+t print table of contents, do not create files 

-U copy unconditionally (normally old will not replace 
new) 

-V verbose, name each file as it is copied 

-6 process UNIX Version 6 files 


cpp [options] [files] 
C language preprocessor 


-B support // as a comment (C++) 

-C pass all comments 

-H print pathnames of included files 

-M generate makefile dependency list 

-p use only 8 characters for symbols 

-P do not produce line control information 

-R allow recursive macros 

-T use only 8 characters for preprocessor names 
-undef remove all predefined symbol definitions 


-Dname[=def] define name as 1 [def] 

-| dir include directory 

-Uname undefine name 

-Ydir use dir instead of /usr/include for includes 


crash [options] 
examine system images 


-d dumpfile system memory image, default /dev/mem 
-n namefile default /vmunix 
-w file write to file 


crontab [options] 
user crontab file 


file copy crontab file to admin directory 

-e username edit username's crontab file 

-r username remove username’s crontab file 

-| username list username’s crontab file file format is: 


min hour day mon weekday 
string min 0-59, hour 0-23, day 1-3, mon 1-12, 


weekday 0-6 0=sun, * = all values or list with, string 


is command. 


csh [options] [argument..] 
shell command interpreter with C like syntax 
-b do not interpret subsequent arguments as options 


-C read commands from first filename argument 
-€ terminate if a command returns non zero 

-f fast start - do not read .cshre or .login 

+ forced interactive 

-n interpret input but do not execute commands 
-§ take commands from standard input 

+t read and execute a single line 

+ verbose 

-x echo commands 


csplit [options] 
context split a file 


file argl [..argn] 


-s do not print size of each created file 
-k leave created files if an error occurs 
-f prefix files are called prefix00..n, default is xx00..n 


args 


ctags [options] 


/rexp/ create file up to line including rexp 
%rexp% kip up to line including rexp 

Inno create file from current line to Inno 
[num] repeat argument 


filename 


create a tags file for ex or vi 


cu [options] 


append output to existing file 

use backward searching patterns 

use forward searching patterns (default) 
create tags for typedets 

update specified files in tags file 
produce an index for vgrind 

suppress warning diagnostics 

produce list of object names 


{destination] 


call another UNIX system 


-d 
destination 
-|line 

-S speed 
-e 


commands 


print diagnostics 
phone no, system name or LAN address 
direct connection 
data rate, default from /etc/uucp/Devices 
force even parity 
half duplex 
request user prompt for phone number 
force odd parity 
dial an auto-answer terminal 
after connection established 
terminate conversation 
! escape to a local shell 


%cd change directory on local system 
take from to 
%put from to 


date [options] 
print and set the date 


“u 


yymmddhhmm 


display in Greenwich Mean Time (default local) 
year, month, day, hour, minute 


dbx [options] 
source level debugger 


-fc 


-kbd 

-P fd 

Tv 

-s startup 
-sr tstartup 
de 


estimate of number of functions is c [500] 
force input terminal style 

add dir for source file search 

kernel debugging 

debug a program that uses keyboard up/down 
create pipeline to dbxtool process 

execute objfile immediately 

read initialization from startup 

read init from temp tstartupo and then remove 


desk calculator (reverse polish style) 


dd [options] 
convert and copy a file 


if=file 
of=file 
ibs=n 
obs=n 
bs=n 


input file name, default stdin 
output file name, default stdout 
input block size n bytes (512) 
output block size n bytes (512) 
input and output block size 
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cbs=n conversion buffer size 

files=n copy and concatenate n files 

skip=n skip n input blocks before start 

seek=n as for skip for seek devices 

count=n copy only n input blocks 

conv=x x is ascii|lcase|ucase|swab|noerror|sync 


deroff [options] [files] 
remove nroff/troff, tb] and eqn constructs 


files file(s) to remove from 
-w output a word list 
devinfo 


print system device information 


devnm name 
identify device name 


df [options] 
report free disk space on file systems in 1024 byte blocks 
-a report on all filesystems 
-i report number of used/free inodes 
-t type report on type file systems (eg nfs) 


diff [options] filel file2 
find differences in two files or directories 


-b ignore trailing blanks 

-i ignore case 

+t expand tabs in output 

-w ignore all blanks 

-e produce output suitable for ed 

-| long format (directories only) 

+r recursively (directories only) 

-S report identical files (directories only) 


diff3 [options] filel file2 file3 
three way file comparision (SYSV) 


diffmk old new marked 
mark differences between versions of a troff input file 


digestp [see mailp] 
Frontend to PostSript printer for USENET digest files (OWV3) 


dircmp [options] dirl dir2 
directory comparison (SYSV) 


-d create list of all file differences 
-S suppress identical file messages 
-wn width of output is n (default 72) 


dis [options] file 
COFF object code disassembler 


-O print in octal 

V print version number 

-L look up source labels (-g only) 

-d sec disassemble sec as data 

-da sec disassemble sec as data and print address 
-F func disassemble only func 

-t sec disassemble sec as text 


1X disassemble library libX.a 


dkinfo disk 
report information on a disk configuration 


domainname [newname] 
get or set name of current secure RPC domain 


du [options] [names] 
summarize disk usage in 1Kbyte blocks 


names file or directory names to summarize 
default is current directory 

-s only print grand total of specified names 

-a generate information for each file 


default is each directory 


dump [options] fs|file 
incremental file system dump 


0-9 dump level 

a archive create contents in file archive 

b factor blocking factor 

c cartridge 

d bpi tape density 

D diskette 

f dumpfile dump to dumpfile not /dev/rmt8 

n notify to operator group 

s size size of volume 

t tracks tracks for a cartridge 

u update dump record 

Vv verify 

Ww list file systems needing backup 

Ww list all file systems, including w 
dumpfs 


dump file system information 


echo [args] 
echo arguments 


ed [options] [files] 


text editor 
-S suppress printing of diagnostics and some info 
-p specify a prompt string 
-X use encryption 
edquota 


edit user quotas 


eject [options] [device] 
eject media from drive with no manual eject 


-d display default device 
-f force eject if busy 

-n display nicknames 

-q is media present 


device|nickname 
device to eject 
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enable _saveresume [device] 
modify Save/Resume status 


device 


env [name=value] 


alternative partition that is to be used for save and 
resume. 


[command] 


print or set environment for command execution 


eqn [options] file 
typeset mathematics 


-dxy 


error [options] 


set equation delimiters to x and y 

change font globally to n 

reduce sub and superscripts by n point sizes 
change point size globally ton 


[files] 


categorize compiler error messages 


-n 


do not touch files, errors to stdout 


-q interactive query mode 
vv invoke vi on completion 
-t list list is suffices eg .c.y.f* 
-S print statistics 


etherfind [options] 
find packets on Ethernet 


-d print no of dropped packets 
n do not convert address/port to names 
-p do not go promiscous 

r RPC mode 

+t timestamp each packet 

-u make output buffered 

Vv verbose 

x dump packet in hex 

-c count exit after count packets 

-i interface listen on interface (netstat) 
-| length limit no of bytes (with -x) 
expression eg dst dest, src source etc 


ex [options] file 


text editor 

-S suppress feedback 

-V invoke vi 

-r file recover file after system crash 

-L list files saved after system crash 
-R read only 

-V verbose 

-| set up for editing LISP programs 
-x use encryption 

-c command start by issuing command 


expand [options] [files] 


unexpand [-a] [files] 
expand tab characters to space characters and vice versa 


-tabstop sets TAB as tabstop characters (default 8) 
-tab1,tab2... set TAB at columns specified 
“a insert TAB for 2 or more spaces 


exportfs [options] [path] 
-a export all in /etc/exports 
-i ignore options in /etc/exports 
-u unexport paths 
-V verbose 
-0 options ro|rw=host{[:host..]|anon=uid|root=host{[:host..] 


jaccess=client{[:client..]|secure 


expr args 
evaluate arguments as an expression 


extract_unbundled 
extract and execute unbundled product installation scripts 


extvga arg 
turn on the SPARCbook VGA port 


0 off 
1 on 
fastboot 


shutdown the operating system and reboot 


fasthalt 
shutdown the operating system and switch off 


faxp [see mailp] 
frontend to PostScript for fax files (OWV3) 


faxtool [file] 
send facsimile to modem port (OWV3) 


fdformat [options] 
format diskette 


-b label put MS-DOS label on disk after formatting 
-d install MS-DOS file system and boot sector 
| do not ask for confirmation 
-| format a low density (720K) diskette 
v verify after format 
file [options] [files] 
determine file type 
-C check magic file for format errors 
-f names names contains list of files to examine 
rk follow symbolic links 
-m mfile use mfile as magic file not /etc/magic 


filemgr [options] [xview options] 
OpenWindows mouse-based file manager (OWV3) 


-d directory start in specified directory 
-inum check on files every num seconds 
-a check file modification times 


xview options see xview 
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filep [see mailp] 
frontend to PostScript printer for ASCII files (OWV3) 


find pathlist expr 


find files 

-name pattern true if pattern matches filename 

-perm onum true of permission matches onum 

-size n[c] true if n blocks or n characters if c specified 

-atime n true if accessed n days ago 

-mtime n true if modified n days ago 

-ctime n true if status changed n days ago 

-exec cmd true if executed cmd returns zero, 
terminate with \; {} is current pathname 

-ls print pathname and statistics 

-ok cmd interactive version of exec 

-print print current pathname 


-newer timefile _true if file modified more recently than timefile 


-depth do directory entries before directory 
-prune do not descend into directories 
-cpio device write in cpio format to device 

-ncpio device write in cpio -c format to device 


-local true if file physically on local file system 
( expression ) true if expression true 


-typec true if type of file is b block, c character, 
d directory, | symbolic link, p fifo, f plain 
file, s socket. 

-links n true if file has n links 

-user name true if file belongs to name 

-nouser true if file belongs to an unknown user 

-group name true if file belongs to group name 

-nogroup true if file belongs to an unknown group 

-fstype type true if filesystem file is in is of type 

-inumn true if file has inode number n 

-xdev do not traverse a different filesystem 

an example find dir -atime +7 -exec rm } \; 


removes all files in dir older than a week 


finger [options] [users] 
display information about local and remote users 


-b suppress home directory and shell in long format 

-f suppress header 

-h suppress .project file 

-i idle format 

-| long format 

-m match only on user name 

suppress .plan file 

-q quick format output 

-S short format 

-w suppress full name 
fixframe 


convert FrameMaker 2.0 PostScript files (OWV3) 


fixinterleaf 
convert Interleaf PostScript files (OWV3) 


floppytool [xview options] 
simple floppy backup/restore (OWV3) 


xview options see xview 


fmt [options] [files] 
simple text formatter 
-c crown margin mode 
“Ss split line only, do not join 


-w width output width columns, default 72 


fold [-width] 
fold long lines 


[files] 


format [/dev/rdsk/x] 
format a hard disk and set partition table 


fpuversion4 
print the SPARC FPU version 


from [options] 
display sender and date of mail messages (UCB) 
username use usernames mailbox (default is yours) 
-s sender only display headers from sender 


fsck [options] 
check and repair file systems 


-b block use block as superblock (32 is alternate) 
-w check writable file systems only 

y assume yes responses whatever 

-n assume no, open file system ro 

c convert to dynamic table format 


fsirand [-p] special 
install random inode generation numbers 
-p print generation numbers but do not change 


ftp [options] 
file transfer program 


[hostname] 


-d enable debugging 
-g disable filename ‘globbing’ 
-i turn off interactive prompt in multiple transfers 
-n no auto-login 
-V show responses from remote server 
commands !command run command on local machine 
helpget help 
get remotefile localfile 
put localfile remotefile 


fuser [options] file|resource 
identify processes using a file or structure 
cancel current options 
-k send SIGKILL to each process 
-u print user login name 


gcore [-o file] pid 
get core image of running process 


getopt 
getopts 
parse command options 
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gprof 
display call-graph profile data 
-a suppress statically declared functions 
-b brief 
-C static call graph 
-S produce gmon.sum profile file 
-Z display routines with zero usage 
-elf fun display for routine fun and descendants 
-E fun suppress display for routine fun 
-F fun use only fun times in calculating statistics 


graph [options] 
draw a graph 


-a sp [st] supply abscissaes, spacing sp, start st 

-b disconnect graph after each input label 

-c string string is default label for each point 

-g grid grid=0 no grid, 1 frame with ticks, 2 full grid (default) 
-| label label is label for graph 

-m mode mode=0 disconnected, 1 connected lines 

-S save screen, do not erase first 


-x [I] lo [up [sp]] _ l=log, lo and up=limits, sp=grid spacing 


-y [I] lo [up [sp] l=log, lo and up=limits, sp=grid spacing 
-hf fis fraction of space for height 

-w f f is fraction of space for width 

rf f is fraction of space right before plotting 
-uf fis fraction of space up before plotting 
+t transpose x and y axes 


grep [options] expr [files] 

egrep [options] expr [files] 

fgrep [options] string [files] 
search a file for a pattern using limited regular expression 
search a file for a pattern using full regular expression 
search a file for a character string 


-b print block numbers for found instances 

-C print only a count of lines 

“i ignore case distinction 

-h do not print filenames for multiple files 

-| list only filenames with matching lines 

-n print line numbers for found instances 

-S work silently 

-V print lines except those that contain expr 

-f file take list of expressions from file 

-x print only lines that entirely match string (fgrep only) 
groups [user] 


print group membership of user 


grpck 
check group database entries 


halt [options] 
stop the processor 


-n do not sync 
-q quick halt 
“+y halt, even from a dialup terminal 


head [-n] [file] 
display first lines of a file 
-n number of lines, default 10 


hostid 
print hexadecimal host identifier 


hostname 
print system hostname 
id 
print user and group name and ID 


ifconfig interface [ address_family ] 
configure network interface parameters 


-a apply the commands to all interfaces 

-ad apply the commands to all “down” interfaces 

-au apply the commands to all “up” interfaces 

up mark an interface “up”. 

down mark an interface “down”. 

trailers cause a non-standard encapsulation of inet packets 
-trailers disable the use of a “trailer” 


arp enable Address Resolution Protocol 
-arp disable the use of the Address Resolution Protocol. 
private interface should not be advertised. 


indent file [options] 
indent and format a C program source file 


-bap insert blank line after each procedure 
-bacc insert blank line round conditional block 
-bbb blank line before block comment 

-nbe no new line after declaration comma 
-bl reformat if (...) { with a new line 

-bs force a blank after sizeof 

-cn nis col to start comments [33] 

-cdn nis col to start declarations [as cn] 
-nnedb allow /* comment */ 

-nce do not force else to preceding } 

-nfct disable formatting of comments in col 1 
-in nis number of spaces per indent level [4] 
-In nis max length of line [78] 

-sob remove optional blank lines 

-st pass stdin to stdout 

-troff generate troff code 

-V verbose 


indxbib file 
create an inverted index to a bibliographic database 


inline [options] files 


in-line procedure call expander 


-w display warnings 

~V verbose 

-0 file write to file 

-i inline read in-line code templates from inline 
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install [options] files 
install files 


-g group set group of installed file/directory 
-m mode set mode of installed file/directory 
-O owner if root, set owner of file/directory 
-s strip executables as copied 

-d create a directory 


iostat [options] 
report I/O statistics 


-c report user/system/idling times 
-d report disk info 

-D more disk info 

-| report counts not rates 

+t report terminal character info 
disk specify disk 


interval [cnt] report every interval secs, print cnt reports 


ipcerm [options] 
remove a message queue, semaphore or shared memory ID 


-q msgid remove message queue identifier 

-m shmid remove shared memory identifier 

-s semid remove semaphore identifier 

-Q msgkey remove message queue created by msgkey 
-M shmkey remove shared memory created by shmkey 
-S semkey remove semaphore created by semkey 


ipcs [options] 
report inter-process communications facilities status 


-q info about active message queues 

-m info about active shared memory segments 
-S info about active semaphores 

-b info on biggest allowable size 

-c creators login name and group 

-0 outstanding usage 

-p PID info 

+ time info 

-a all options 

-C corefile corefile, default /dev/kmem 


-N namelist namelist, default /stand/unix 


join [options] filel file2 
relational database operator 


-an additional line for each unpairable line in file n 

“eS replace empty output fields with string s 

-jnm join on mth field of file n, if no n both files 

-0 list include fields specified in list, elements n.m 

-tc use c as a separator (default tab) 
kbconfig 

configure SPARCbook keyboard setup 

+r reconfigure keyboards. 

-i layout set internal keyboard layout 

-p layout set PS/2 keyboard layout 

-t layout set target keyboard layout 

-f flags set the keyboard configuration control flags. 


keylogin 
decrypt and store secret key 


keylogout [-f] 
delete stored secret key 
-f forget the rootkey 


kill [-signal] pid 
terminate a process by default 


-signal signal to send (default SIGTERM) 
pid process ID, or process group ID 
-| list signals 


last [options] 
indicate last user or terminal logins 
-ninum limit number of entries to num 
-f file use file, default /var/adm/wtmpx 


lastcomm [options] 
show last commands executed in reverse order 


command only show specified command entries 
user only show entries for specified user 
term only show entries for specified term 


ld [options] files 
dynamic link editor 


-align datum force datum to be pagealigned 
-assert key check assertion for key 
key is definitions|nodefinitions| 
nosymbolic|pure-text 
-A incremental loading 
-Bkey key is dynamic|nosymbolic|static|symbolic 
-d force allocation of common storage 
-de -d and copy initialized data from shared objects 
-dp force alias definition of undefined entry points 
-Dn pad data segment to n (hex) bytes long 
-e entry define entry point 
-IxLv] include libx.a[.v] 
-Ldir add dir to library search list 
-M produce load map 
-n text ro with data following text 
-N do not make text ro 
-O name output to file name 
-p data segment to start on page boundary 
+r generate relocation bits for another Id 
-S strip output 
-S strip output except for locals and globals 
+t trace 
-Tn start text at hex address n 
-Tdata n start data at hex address n 
-u name name is an undefined symbol 
-X preserve only global symbols 
-X record local symbols 
-ysym display each file in which sym appears 
Z demand paged process 
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ldd files 
list dynamic dependencies 


ldf [fontname] 
list and load PostScript defined NeWS font (OWV3) 


leave [[+] hhmm] 
remind you when it is time to leave 
+[hh]mm incremental time from now 
led on/off 
turn the user LED on or off 


lex [options] [files] 
lexical analysis program generator 


-f fast mode, do not pack tables 

-t output to stdout [lex.yy.c] 

-V print summary of statistics 
level 


monitor battery level. 


line 
read one line 


lint [options] files 

C program verifier 

-a report assignments of longs to non long variables 

-b report break statements that are not reached 

-C complain about non-portable casts 

-h heuristic tests 

-i produce a .In file 

-n do not check compatibility with libc 

-q do not complain about non-Sun compiler 
portability problems 

-u do not complain about used and not defined, 
or defined and not used, varaiables 

Vv do not complain about unused function args 

-x report non-used externs 

-Z do not complain about non-defined structures 

-Clib create llib-llibrary.In 

-Dname[=def] define name for cpp 

-Idir add dir to include search 

-llib use lib not /usr/lib/lint 

-0 file output file 

-Uname undefine name 


ln [options] files target 
link files 
-f no questions asked 
“Ss create symbolic link 


loadkeys [file] 


dumpkeys 
load and dump keyboard translation tables 


logger [options] 
add entries to the system log 
-t tag mark each added line with tag 
-p priority 
-i log pid of logger process 
-f file use file as message 


enter message with specified priority 


message message to log 
login [-p] [name] 

sign on to the system 

-p preserve environment 
logname 


get login name 


look [options] string [file] 
find words in system dictionary or lines in list 


file file to use [/usr/dict/words] 

-d dictionary order 

-f fold case 

-te all chars to right of c are ignored 
lookbib 


find references in a bibliographic database 


lorder files 
find an ordering relation for an object library 


lp [options] [files] 


cancel [options] printers 
send/cancel requests to the LP print service 
“Cc make copies before printing 
-ddest dest is printer 


-m send mail on completion 


-nnum num is number of copies 

-ooption printer-dependant options 

-S suppress messages 

-t title print title on banner page 

-w write a message or send mail on completion 


lpc [command] 
line printer control program 
help lists available commands 


lpq [options] 
display queue of printer jobs 


-Pprinter specified printer 
= long format 
+[interval] display periodically until empty (seconds) 
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lpr [options] 
send a job to the printer 


-Pprinter specified printer 

-#num num copies of each file 

-Cclass class is job classification 

-Jjob job is job name 

-Ttitle title is title name 

-i[n] indent output n characters (default 8) 
-n font nis 1-4, mount specified font 

-wools cols is page width (default 72) 

-m send mail on completion 

+r remove file on completion of spooling 
-h do not print burst page 

-S do not copy files 

-p filter through pr 

-| print control chars, no page breaks 

+t filter through troff 

-g files contain plot data 

v files contain a raster image 


lprm [options] 
remove jobs from the printer queue 


-Pprinter specify printer 

= remove all your jobs, if root all jobs 
job job number 

user jobs owned by user 


lpstat [options] 
print information about status of LP print service 


-a [list info on print destinations 
-¢ [list] info on classes 
print system default printer 

ist info on output requests 
-p [list status of printers 
+ info on scheduler 
-S status summary 
+t all status 
-u [list print status on users to default printer 
-v [list] print names and devices 


lptest [options] 
generate lineprinter ripple pattern 
[I [cl] lis line length (default 79) 
c is line count (default 200) 


1s [options] [names] 
list contents of a directory 


-a all entries including . entries 

-A as -a but not. or.. 

-C use time for sort 

-d only list name of directories 

-f force directory interpretation 

-F add / directory, * executable, @ symbolic link 
-g show group ownership in long format 
-i list inodes 

-| long format 

-L list referenced file not symbolic link 
-q show non-graphic characters as ? 

+r reverse order 

-R recursively down directories 


-S list size in blocks 
+t sort by time not name 
-u use time of last access not modification 
a print one entry per line 
lsw 


list TFS whiteout entries 


m4 [files] 
macro language processor 


mach 
display processor type 


machid 
return a true status if processor of specified type 


mail [options] 
mail [-deHinNUv] [options] 


mail [-dFinUv] [options] recipient 
read mail or send mail to users 


read mail 

send mail 

-d turn on debugging 

-e test for presence of mail 

- file record mail in file 

-H print header summary 

-i ignore interrupts 

-n do not use Mail.rc 

-N do not print header summary 

-U convert UUCP style to internet 

~ pass -v to sendmail 

-f file read from file [mbox] 

-f +folder use file folder in folder dir 

-h num num is number of network hops 
-r address pass address to delivery software 
-S subject set Subject header field to subject 
-T file print contents of all ops on file 

-u user read users's mailbox (if not ro) 
commands help - print command summary 


mailp [options] file 
frontend to the mp PostSript pretty printer (OWV3) 


-S subject use subject as new subject 
-h no banner 
-F print who mail is from rather than for 


-| print 2 pages per page in landscape mode 


mailstats 
print statistics collected by sendmail 


mailtool [options][xview options] 
OpenWindows interface for the mail program (OWV3) 


-Mx expert mode 
-Mi int check for mail every int seconds 
xview options see xview 
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make [options] 
maintain, update and regenerate programs and files 


-f makefile use makefile [m|Makefile] 
-d display reasons for rebuilding 
-dd verbose display 
-D display makefiles read 
-DD display makefiles and hidden dependencies 
-e environment variables override makefiles 
-i ignore error codes returned 
-k stop on current tree when error 
-n print but do not execute commands 
-p print complete macro and target descriptions 
-P report dependencies, do not build 
-q question mode 
-r do not read in default makefile rules 
-S silent mode 
undo effect of -k option 
+t touch targets but do not perform rules 


macro=value macro definition 
makefloppybu 

make a backup to floppy 

-number estimate required disks 


makeminifs [-d] 
make a copy of the minifs on floppy disk 
-d delete the minifs from the hard drive 


makenetbu [options] 
make a backup over the network 
system remote hostname 
device backup device [nrst8] 


man [options] names 
display manual reference pages 
-t troff pages for output 


-M path change search path 
-T macros use macros, default tmac.an 
-k keyword find all entries relating to keyword 


-f filename locate entries relating to filename 


mconnect [options] [hostname] 
connect to SMTP mail server socket 


-p port specify port, default is 25 
-r raw mode 


mesg [-n][-y] 
permit or deny messages 
-n do not allow write messages to your terminal 
-y allow write messages to your terminal 


mkdir [-p] dirnames 
make directories 


-p make all non-existent parents first 


mkfile [options] file 


make a file 
-n create empty filename 
Vv verbose 


mkfs [-N] device size [options] 
make a file system 


-N print parameters but do not make FS 

options these are in order 

size size in blocks (512 bytes) 

nsect sectors per track [32] 

ntrack tracks per cylinder [16] 

blksize 4096|8192 default is 8192 

fragsize fragment size 512-8192 [1024] 

ncpg cylinders per group [16] 

nbpi bytes per inode block [2048] 

opt t|s for time or space, default t 

apc alternates per cylinder [0] 

rot ms to service transfer complete and initiate new 
transfer [1] 

nrpos no of distinguished rotational posns [8] 

maxcontig max no of blocks before delay [1] 


mknod name b|c major minor 
make a special file 


mkstr [-] mp f 
create an error message by massaging C source files 
place error messages at end of specified file 


m messagefile 
p prefix for creating files 
f filenames 


modload filename[options] 
load a kernel module 


VV verbose 

-A unix_file default /unix 

-conf confile configuration file 

-entry point entry point, default xxxinit 

-exec file execute file if successful load 

-0 file linker output file 
modstat 


display status of kernel loadable modules 
modunload -id n [option] 


unload a module 
n module id from modstat 
-exec file execute file if successful unload 


more [options] 


page [options] 
browse or page through a text file 


-c clear before displaying 

-d display error messages 

-f do not fold long lines 

-| do not reat FF as page break 

-S replace multiple blank lines with single 
-u suppress highlighting 

-num display num lines in each screenful 
+num start at linenumber num 

+/string start 2 lines above line containing string 
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mount [options] 


umount [options] 
mount or unmount file systems and remote resources 
~v verbose 


-p print list suitable for fstab 

-a mount all in fstab 

-f fake mtab entry but do not mount 
-n do not make mtab entry 

-t type fstype 4.2|nfs|rfs|lo|hsfs|tmp 

+ read only 


-0 options file system options 


mp [options] 
PostScript pretty printer (OWV3) 


-F header with mail from, default mail for 
-PS print PostScript input as text 

-a format as a news article 

-d format as a digest 

-f format for use with a Filofax 

-| output in landscape, 2 pages per page 
-m output as a mail folder 

-0 output as a normal ASCII file 

-p file use file as PostScript prologue 

-s name use name as subject for printout 

-tm output for use with Time Manager 

-ts output for use with Time/System International 
~ print version 

-? print usage 


mt [-f£ device] command [count] 
magnetic tape control 


eof write count EOF marks 

fsf forward space over count EOF marks 
fsr forward space count records 

bsf back space over count EOF marks 
bsr back space count records 

eom go to end of recorded data 

rewind rewind tape 

offline rewind and take tape offline 

status print status info 

retension rewind, fast forward, rewind 

erase erase the tape 


mv [options] files target 


move files 
-i confirm before overwriting 


-f overwrite in any case 
nawk 

pattern scanning and processing language 

+t file file is source 

Fe field separator is c 

var=value set var to value 


netstat [options] 
show network status 


-a show state of all sockets 

-i show interface state 

-m show private buffer pool info 

-n show network addresses as numbers 
+r show routing tables 

-S show per-protocol statistics 

-f inet|unix show only one family 


newaliases 
rebuild the data base for the mail aliases file 


newfs [options] [mkfsopts] raw 
create a new file system 


-N print out parameters only 
~V verbose 
mkfsopts -a apc, -b size, -C maxcontig, -c cpg, -d rotdelay, 


-f fragsize, -i bpi, -m free, -o opt, -r rpm, s size, 
-t tpi, -n nrot (See mkfs) 
raw raw device 


newgroup group 
log into a new group 


newsp [see mailp] 
frontend to PostSript printer for USENET news articles (OWV3) 


newsserverstr [host] [portno] 
generate a string for the NEWSSERVER variable (OWV3) 


nfsstat [options] 
Network File System statistics 


-c display client configuration 

-m display stats for each NFS mounted FS 
-n display NFS info 

+r display RPC info 

-S display server info 

-Z zero statistics 


nice [-inc] command 
run a command at low priority 
-inc inc = —20 to 19, default 10, 19 is lowest. Root may 
use —n to increase priority. 


nl [options] 
line numbering filter 
-btype type=a number all lines, t number lines with 
printable text, n no lines, pexp lines with regular 
expression exp 


-ftype as -b for footer 

-htype as -b for header 

-vnum num is start number, default 1 

-iinc inc is increment, default 1 

-p do not restart at page throws 

-Inum num is no of blank lines considered as 1, default 1 

-ssep sep is character to separate line number and line 
default is tab 

-wwidth width is no of characters for line number [6] 


301 


-nformat formatz=ln left justified, rn right justified, rz right 
justified with zeroes 


-ddelim delim is logical page section start (default \:) 


nm [options] [files] 
print symbol name list 


-a print all symbols 

-g print only globai symbols 

-n sort numerically not alphabetically 

-0 prepend file or archive element to each lin 
-p do not sort 

+ sort in reverse order 

-§ sort by symbol size 

-u print only undefined symbols 


nohup command 
run a command immune to hangups and quits 


nroff [options] 
format documents for display or line printer 


“6 produce equally spaced words 

-h use output tab characters 

-i read stdin after input files exhausted 
-q invoke simultaneous input-output 
-mname prepend tmac.name to input files 
-nN number first page as N 

-opagelist page range specifier 

-raN set register a to N 

-sN stop every N pages (default 1) 
-Tname prepare output for device name 


nslookup [-1] [address] 
query name servers interactively 
-| use local hosts name server 
address use name server on machine with internet address 
od [options] file [offset[.|b] 
octal dump 


-a interpret bytes as chars and display by name 
-b interpret bytes as unsigned octal 
-C interpret bytes as unsigned chars 
interpret shorts as unsigned decimal 
-f interpret longs as fp 
-h interpret shorts as hex 


“i interpret shorts as signed decimal 
-| interpret longs as signed decimal 


-0 interpret shorts as unsigned octal 

s[n] look for strings of n ASCII chars [3] 

v show all data 

w([n] display n bytes per line 

x interpret shorts as hex 

offset from beginning of file . is decimal, b is 512 byte 


blocks, default is octal bytes 


olvwm [options] 
OPEN LOOK virtual window manager for OpenWindows (OWV3) 


-2d/3d use 2/3 dimensional look (default 3) 
-display string use string as display, overrides DISPLAY 
-f, -follow use focus-follows-mouse mode 

-fn name use name font for window titles 


-name rname use rname to look up resources 
-parent ignore windows already on screen 

-xrm rstring specify resources in rstring 

-single manage windows for single screen only 
-multi manage windows for multiple screens 


olwm [options] 
OPEN LOOK window manager for OpenWindows (OWV3) 


-2d/3d use 2/3 dimensional look (default 3) 
-display string use string as display, overrides DISPLAY 
-f, -follow use focus-follows-mouse mode 

-fn name use name font for window titles 


-name rname use rname to look up resources 


-parent ignore windows already on screen 
-xrm rstring specify resources in rstring 
on [options] host command 
execute a command on a remote system 
i interactive mode 
-d debug mode 
no input 


openwin [options] 

OpenWindows startup script (OWV3) 
use name as server, default xnews 
do not use MAGIC COOKIE 


-server name 
-noauth 


pack, pcat, unpack files 


compress and expand files 


pagesize 
display size of a page of memory 


pageview [options] 
PostScript previewer for OpenWindows (OWV3) 


-mono use mono canvas 

-w num width is num inches, default 8.5 
-h num height is num inches, default 11 
-dpi num num dpi, default 85 

-med num colordensity, default 100 

-page num start at page num 

-dir name set working dir to name 

-orient orient is left|right|upsidedown - 
-aa turn on anti-aliasing 

Vv version 


passwd [options] name 
change login or NIS password and attributes 


-a display name and aging info for all users 

-f change the full name 

-| change the local name (default) 

-s change the login shell 

“y change passwd, shell or full name in NIS dbase 
-d [user] display name and aging for user 

-e user expire password for user 

-F name treat name as the password file 

-n num user set maturity for users password to num days 

-x num user set expiration for users password to num days 
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paste [options] filel file2 
merge same lines of several files or subsequent lines of one file 
- use instead of filename for filter/pipe to read from 
standard input. 


-d’chars” replace newline characters in each but last file with 
alternate chars, default tab 
-S merge subsequent lines rather than one from each 


file 


pax [options] 
portable archive exchange (SYSV) 


-W write files out 

-r read files in 

-rw copy files 

-a append to specified archive 

-C complement pattern match sense 

-d do not create intermediate directories 


-i interactively rename files 
-l link files arther than copy if possible 


-m do not retain file modification times 

-n if -r treat files as ordinary filenames 

-0 retain file ownership 

-p preserve access time of input files 

-u copy file only if newer 

~ list files 

-y prompt for disposition of each file 

-bn blocking factor n bytes or nk KB or nb blocks or nm 
MB 

-f archive specify name 

-s string string is ed syntax /old/new/[gp] 

-t device name input or output device 

-x format format is cpio|tar 


paxcpio [options] 
copy archive files in and out (SYSV) 


-O cpio out 

<i cpio in 

-p cpio pass 

-a reset access times 

-B block 5120 bytes per record 
-C write header info in ASCII 

-d create directories as required 
-f copy all files except patterns 
-| link files where possible 

-m retain modification times 

+ interactively rename files 

+t print table of contents 

-u copy files unconditionally 

~v verbose 


perfmeter [options] 
display system performance in dials or charts (OWV3) 


-a display all values simultaneously 
-cn number of samples to cache 

-d use metered dials 

-g use strip charts 

-h int set hour hand to int seconds 


-l log samples to file 
set minute hand to int seconds 
file is for perfmeter samples 


-name app 

-p len 

-s time 

-t value 

“v 

-C chart ceiling 
-H 

-L 

-S 


pg [options] 


app is application name to get resources 
page length [60] 

time is sample time in seconds 
cpu|pkts|page|swaplintr|disk|cntxt|load |colls|errs 
show version number 

set Ceiling for chart 

display horizontally 

display strips in line 

display charts solid filled 

display vertically 

no title line 

with title line 


[files] 


file perusal filter for CRTs (SYSV) 


-num 
-C 

-e 

-f 

-n 

-p string 
-S 

+num 
+/pattern/ 


specify no of lines, default to fit terminal or window 
clear screen at start 

do not pause at each end of file 

do not split lines 

do not wait for newline on command 

use string as prompt - can contain %d 

highlight messages 

start at linenumber 

start at first line containing pattern 


ping host [timeout] 
send ECHO_REQUEST packet to network hosts 


timeout 


pm 


seconds to wait for response (default 20) 


OpenWindows Process Manager (OWV3) 


poptool 


OpenWindows tool for the POP service 


-d 
-h 


pr [options] 


print files 


-h string 
-In 

-s[c] 
-wn 

-n 

+n 


enables debugging of the POP session. 

‘pophost'’ specifies ‘pophost’ as the name of the 
machine running the remote pop daemon. 
specifies that poptool should leave a copy of the 
mailbox on the remote server. 

Quiet. Tell poptool to be non-verbose. 

username specifies ‘username’ as the login on the 
remote host. 


[files] 


use formfeed not newlines for pages 
print all files simultaneously, 1 per col 
do not print header/trailer 

use string in place of filename in header 
n is number of lines [66] 

separate cols by c not whitespace [tab] 
n is width in columns [72] 

produce n column output 

begin at page n 
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printenv [variable] 
display environment values currently set 


printtool [xview options] 
OpenWindows tool for printing files (OWV3) 


xview options see xview 


prof [options] 

display profile data 

-a report all symbols 

-| sort by symbol value 
sort by number of calls 


produce summary in mon.sum 
display routines with zero usage 


<NO@S 


-v [-low[-high]] produce graphic output for plot low and high are 


percentages 


ps [options] 
report process status 


“a include processes owned by others 
-c display command name 

-C display raw CPU time 

-e display environment as well as args 
-g display all processes 

| listing for job control information 

-k use /vmcore 

-| long listing 

-n produce numeric output 


r only ‘running’ processes 

Ss display accumulated time, including children 
u user oriented output 

-U update private database 

Vv describe virtual memory information 

Ww used 132 col output 

x include processes with no controlling terminal 
“x processes for terminal /dev/ttyx 

num process info for pic num 


psh [files] 
NeWS PostScript shell (OWV3) 


psps 
NeWS process lister (OQWV3) 


pstat [options] 
print system information 
-a all process slots 
-f print open file table 
“i print inode table 
p print active process table 
-S print streams table 
Ss print swap space usage info 
aT print used/free slots in system tables 
-u pid print info on process pid 


ptx [options] 
generate a permuted index 


-f fold upper and lower cases 
ay prepare output for phototypesetter 
-wn output is n characters width [72] 


-gn n characters gap per line [3] 
-o only use file only for Keywords 


-i ignore use file ignore for keywords to ignore 

-b break use file break for word separators 

+r leading non-blank chars are identifiers 
pwek/grpck 


check password and group files 


pwd 
print working directory name 


pwrman [options] 
SPARCbook power manager 


-disk n seconds to disk spin down 
-screenn seconds to screen off 
-offn seconds to power down 
-slow 12.5MHz mode 
-normal 25MHz mode 
-reset set factory defaults 
-lowpower 
-nolowpower 
-charge 
-nocharge 
-bright n 

powermgr 


SPARCbook power manager (OWV3) 


quot [options] 
summarize file system ownership 


-a report on all mounted file systems 
-C print blocks, #files, cum total 

-f no of files and space 

-h estimate no of blocks 

-n produce list of all files and owners 
-V files not accessed in 30/60/90 days 


quota [-v] [user] 
display users disk quota and usage 
~v display quota on all mounted file systems 


quotacheck [options] filesystem 
file system quota consistency checker 


“Vv indicate calculated quotas 
-a check files systems in mnttab 
-p run parallel passes on file systems 


quotaon [-av] [filesystem] 
quotaoff [-av] [filesystem] 
repquota [-av] [filesystem] 


turn file system quotas on and off, 
summarize file quotas 
-a turn on/off all file systems with quotas enabled 
-V display messages 
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ranlib [-t] archives 
convert archives to random libraries 
t touch archive but do not modify 


rash [options] 
convert a raster file to a PostScript file (OWV3) 


2 scale by factor of 2 

-nxm scale by nin x, miny 

-swh scale to w wide and h high 

-Hh scale to h high, preserves aspect ratio 
-W w scale to w wide, preserves aspect ratio 
-1xy lower left corner at x y units 

-CXY center at x y units 

-R angle angle to rotate in degrees 

-e output EPSF 

-i produce integral pixel out for input 

-m convert color to 8 bit grey scale 

-n no showpage command at end 

+r print in landscape mode 

-w file use file as PostScript wrapper 


rep [options] from to 
remote file copy 
-p attempt to save modes and times 
+r recursive (destination must be directory) 


rdate hostname 
set system date from a remote host 


rdist [options] 
remote file disribution program 


-b binary conversion 

-h follow symbolic links 

“i ignore unresolved links 

-n print commands but do not execute 
-q quiet mode 

-R remove extraneous files 

~ verify files are up to date 

-w whole mode 

+ younger mode 


-d macro=value define macro 

-c pathnames [login@]hostname[:destpath] 

-f distfile use distfile as description file 
-m host machine to be updated 


read_floppies 
read data from a set of floppy disks 


reboot [options] 
reboot the system 


-d dump core before reboot 

-n do not sync 

-q do not shut down running processes 
-- -S reboot to single user 


refer [options] file 
expand and insert references from a bibliographics database 


-b bare mode 

-e accumulate references 

-n do not serach the default file 

-ar reverse first r author names (default all) 
-estring Capitalize fields with keyletters in string 

-k use labels instead of number references 

+ use labels from authors name and year 

-p file search file of references 

-skeys sort references by fields with keyletters in keys 


remove_programmer 
remove programming suite 


repquota [options] [filesys] 
summarize quotas for a file system 
-a report on all file systems with quotas 
Vv report all quotas 


restore [options] [file] 
incremental file system restore 
i interactive - use help for help 
restore entire tape 
resume restoring 
table of contents 
extract named files 
file dump toc from file not tape 
debug info 
extract dir not referenced files 
extract by inode no 
v verbose 


= a a : 


b factor blocking factor 
f file use file not /dev/rmt? 
sn skip to nth file on tape 


rev [files] 
reverse order of characters in every line 


rgb [dbname] 
showrgb [dbname] 
build or display the color name database (OWV3) 


rlogin [options] hostname 
remote login 


-L run in ‘litout’ mode 

-8 pass 8 bit data across net, default is 7 bit 
-eC use escape character c to disconnect line 
-l user use user as login name 


rm, rmdir [options] files 


remove files or directories 
-f do not prompt on write-protected files 
-r recursive removal 
-i interactive mode 
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rpcinfo [options] 
report RPC information 
-p [host] print list of RPC registered programs 


roffbib [options] 
format and print a bibliographic database 


options as nroff except -i and -q 
rpcgen 

RPC protocol compiler 

-c compile into XDR routines 

-Dname[=value] define name 

-h compile into a header file 

-| compile support for inetd 

-K secs exit if no activity after secs 

-| compile into client stubs 

-L use syslog not stderr 

-m compile into server stubs, no main 

-0 file output file 

-S transport transport is upd|tcp 

+ compile into RPC dispatch table 

-T generate code for RPC dispatch tables 


rsh [options] 


remote shell 

-| user use remote user name 
-n redirect input to /dev/null 
hostname host to execute on 
command command to execute 


rup [options] 
show host status of local machines (RPC version) 
-h sort alphabetically by hostname 
-| sort by load average 
+t sort by up time 


ruptime [options] 
show host status of local machines 


-a count users idele for >1 hour 
-| sort by load average 
-r reverse sort order 


+t sort by up time 
-u sort by number of users 


rusage 
print resource usage for a command 


rusers [options] 
who’s logged in on local machines 


-a report even if no users logged on 
-h sort by host name 

“| sort by idle time 

-| long listing 

-u sort by number of users 


rwall hostnames 
write to all users over a network 


rwho [-a] 
who’s logged in on local machines 
-a all users, even if idle > 1 hour 


sccs [options] 
front end to SCCS 


+ use real user ID not effective user ID 
-dprefix define root portion of pathname for history files 
-pdir directory for history files [SCCS] 


sccs-admin [options] 
create and administer SCCS files 


-b force binary encoding 

-h check structure of existing SCCS file 

-n create new history file 

4 recompute checksum 

-auser|group add user or group allowed to check in/out default is 
any 

-dflag delete flag from SCCS file 

-euser|group erase user or group from authorized list 

-fflag [value] set flag to value 

-iffile] initialize history file from file 

-lrelease unlock release, a for all releases 

-m [list] insert mr numbers into file 

-rrelease specify release for current delta 

+t [file] insert or remove description file 

-y [comment] insert comment 


sccs-cdce [options] s.file 
change the delta commentary of an SCCS delta 


-r sid specify SID of delta to change 
-mmr-list specify one or more mr nos 
-y[comment] insert comment 


sccs-comb [options] s.file 
combine SCCS deltas 


-O access reconstructed file at release delta 
-S generate scripts to gather statistics 
-csid-list include specified list of deltas 

-pSID oldest SID to be preserved 


sccs-delta [options] s.file 


make a delta to an SCCS file 


-n retain the edited .g file 

-p display line by line differences 
-S silent 

-gsid-list list of deltas to omit 

-mmr-list mr numbers 

-rsid specify version to check in 
-y[comment] insert comment 
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sccs-get [options] s.file 
retrieve a version of an SCCS file 


-b create a new branch 

-e retreive version for editing 

-g get SCCS ID only 

-k suppress expansion of ID keywords 

-m precede each line with SID 

-n precede each line with %M% and tab 

-p write text to stdout 

-S suppress stdout output 

+t retrieve most recent delta 

-I[p] retrieve summary of delta table 

-a seq retrieve version corresponding to sequence 

-cdate-time retrieve latest version prior to date time 
yy[mm[ddfhh[mm[ss]]}] 

-Gnew new is name of new version 

-isid-list list of deltas to include in retrieved version 

-rsid retrieve specified version 

-xsid-list exclude specified deltas 


sccs-help [arg] 
get help on SCCS error or warning messages 


sccs-prs [options] s.file 
display selected portions of an SCCS binary 


-a include ail deltas 

-e earlier than delta specified 

-l later than delta specified 

-cdate-time latest delta prior to date-time in format 
yy{mm|da[hh[mm{ss]]]}] 

-dspec produce report to spec 

-rsid SID for which info required 


sccs-prt [options] s.file 
display delta table info from an SCCS file 


-a display log entries for all deltas 
b print body of s.file 

-e everything 

f print flags 


-i print serial nos of included, excluded and 
ignored deltas 


Ss print only first line of delta table entries 

+ print descriptive text in s.file 

-u print user/groups allowed to make changes 
-cdate-time exclude before specified time 

-rdate-time exclude newer than specified time 

-ysid exclude prior to sid 


sccs-rmdel -rsid s.file 
remove a delta from an SCCS file 


sccs-sact s.file 
show editing activity status for an SCCS file 


sccs-sccsdiff [options] s.file 
compare two versions of an SCCS file 


-p pipe output through pr 
-rsid specify version for comparision 
diff-options pass options to diff 


sccs-unget [options] s.file 
undo a previous get of an SCCS file 


-n retain the retrieved version 
-S suppress display of SID 
-rsid specify pending delta to abort 


sccs-valfoptions] s.file 


validate an SCCS file 


-S silent 

-mname compare name with %M% ID keyword 
-rsid check on specified SID 

-y type compare type with %Y% 


script [-a] filename 
make typescript of a terminal session 
-a append to filename 


sdiff [options] filel file2 


print file differences side by side 


-wn output line n characters, default 130 

-| print only left side on identical lines 

-S do not print identical lines 

-o output user controlled merger of file1 and file2 


sed [options] 
stream editor 


-n suppress th edefault output 
-e script script is edit command for sed 
-f sfile take script from sfile 


sendmail [options] 
send mail over the internet 


-ba Arpanet mode 

-bd run as daemon 

-bi initialize the alias databas 

-bp print a summary of the mail queue-bsuse SMTP 
-bt run in address test mode 

-bv verify names only 

-bz create the configuration freeze file 

-Cfile use alternate configuration file 

-dX debugging value of X 

-Ffullname set fullname of the sender 

-fname set name of ‘from’ person 

-hN set hop count to N 

-Mid deliver with message ID id 

-n do not do aliasing 

-Ox value set option x to value 

-q [time] process saved messages at intervals of time 


xs, xm, xh, xd, xw (Secs,mins,hrs, days or weeks), if 
no time process once 


-Rstring attempt to deliver mail with with recipient containing 
string 

+t read message for recipients 

~ verbose mode 
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sh [options] 
standard UNIX command interpreter 


= 
-s 
-c string 


interactive 
read commands from stdin 
read commands from string 


shelltool [options] [xview options] 


-V print version no 


soelim [files] 
resolve and eliminate .so requests from nroff or troff input 


sort [options] 
sort and/or merge files 


run a shell in an OpenWindows terminal window (OWV3) -c check input file is sorted 
-C redirect console output to this shelltool -m merge only 
-B style use style for displaying bold text -u unique 
-| command pass command to shell -ofile use file for output 
xview options see xview -y kmem start bu using kmem KB of memory 
-z size size is longest line 
showmount -T dir dir to place temporary files 
show all remote mounts -d dictionary order 
-f fold lower case into upper case 
showrev [-c command] -i ignore non-printable characters 
show machine and software revision information -M compare as months 
-n sort by arithmetic value 
shutdown [options] time -r reverse comparison sense 
close down the system at a given time *b ignore leading blanks 
-f arrange not to check file systems on reboot “i use x as field separator 
-h execute halt 
-k simulate shutdown sortbib 
-n do not syne sort a bibliographic database 
+r execute reboot 
time +n (mins) or hh:mm or now spell [options] [files] 
report spelling errors 
size [files] -b check British spelling 
display the size of an object file -| follow chains of all included files 
Vv print all words not in list 
slattach x print every plausible stem with = 
attach a SLIP interface to a serial device 0 hilist use hlist as hashed spelling list 
+/-C enable the compression of SLIP packets -h spellhist place mispelled words into spellhist 
+/-e enable automatic detection of compressed SLIP *shstop use hstop as hashed stop list 
packets 
+/-i enable ICMP packets to traverse the interface spline [options] 
+/-p make the interface private to the SPARCbook interpolate smooth curve 
device-n attach interface to the device ‘n’ a supply abscissaes 
device+n attach the interface to device ‘n’, -k arg use k for boundary computation 
local, remote network addresses of two ends of the SLIP link n space output so n intervals 
baudrate specify the serial bauderate “Pp make output periodic 
-x lo hi lo and hi are x limits 
sldetach 


split -n file 
split a file into pieces 
-n size of pieces, default 1000 lines 


detach a SLIP interface from a serial device 


slremote 
form a SLIP connection to a remote system 
spray [options] 


sleep time spray packets 


suspend execution for time seconds -c count count packets, default 100K bytes 
-d delay delay between packets in uS (0) 
' -| length default 86 
snapshot [options] 2 
-t nettype class of transport 


capture image and save to a file 


-d dir use dir for load and save y 
-f file use file for load and save strings [options] file 
9 display color using greyscale ramp find printable strings in an object file or binary 
I file file to view on startup look everywhere (default initialized data only) 
-n do not contirm overwrites -O precede each string by its offset 
-num use num as min string length, default 4 
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strip files 
remove symbols and relocation bits from an object file 


stty [options] 
set the options for a terminal 


-a report all settings 

-g report settings formatted for stty 
speed report speed 

size report window size 


parenb/-parenb enable/disable parity 
parodd/-parodd odd, mark/even,space parity 


cs[5|6|7|8] character size 

0 hang up line 

110..38400 baud rate 

hupcel/-hupcl hang up/do not hang up on last close 


cstopb/-cstopb 
cread/-cread 


use 2/1 stop bits per character 
enable/disable receiver 


clocal/-clocal assume line with/without modem control 

ixoff/-ixoff send/do not send XON/XOFF sequences 
raw/-raw enable/disable raw input (no processing) 
sane reset to a sensible value 

rows n window size n rows 

columns n window size n columns 


su [name] 
become super-user or another user 


sum 
print checksum and block count of a file 


swapon [options] 
specify additional device for swapping 
“a make all devices of type swap in fstab available 
name device or file to add 


symorder [-s] orderlist file 


rearrange a list of symbols 
-S silent operation 


sync 
update the super block 


sys-config 
redo the system configuration 


sys-unconfig 
undo the system configuration 


syslogd [options] 
log system messages 


-d turn on debugging 
-ffile use alterntive configuration file 
-m mins interval between mark messages (20 mins) 


tabs [options] 
set tabs on a terminal 
tabspec -n or -a,-b .... default -8 


tail [options] [file] 


deliver the last part of a file 


+n [I|b|c] start n lines|blocks|chars from start 
-n [I|b|c] start n lines|blocks|chars from end 
-f follow, monitor growth 

+r reverse order 


talk username [tty] 
talk to another user 


tapetool [xview options] 
Read files to and from a tape drive (OWV3) 
xview options see xview 
tar [options] 
tape file archiver 
c create a new tape 
r replace - write files to end of tape 
t list files on tape 
update 
extract 
verbose 
interactive 
use next arg as device/file name 
use next arg as blocking factor (1-20) 
force block filling 


omwors< x 


exit on errors 

i ignore checksum directory errors 

F exclude SCCS files 

FF exclude SCCS, *.o0, core, errs and a.out 
| complain if cant resolve links 

do not restore modification times 
extract with users uid/gid 

restore modes 

follow symbolic links 

nis 0|1|4|5|7|8 use /dev/rmtn 
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tbl [-ms] [files] 
format tables for nroff or troff 


tcopy source [dest] 
copy a magnetic tape 


tcov [options] files 
construct test coverage analysis and profile 
-a display execution count for each statement 
-n display line numbers of n most frequent 


tee [options] [file] 
copy stdin to stdout and file 
“i ignore interrupts 
-a append to file rather than overwrite 


telnet [host [port] ] 
user interface to remote system using TELNET protocol 
fs get help on commands 
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test expr 
condition evaluation command 


-r file true if file is readable 

-w file true if file is writable 

-x file true if file is executable 

-f file true if file is a regular file 

-d file true if file is a directory 

-h file true if file is a symbolic link 

-¢ file true if file is character special 
-b file true if file is block special 

-p file true if file is named pipe (FIFO) 
-s file true if size > 0 

-z$s1 true if length of string s1 is zero 
-nsi true if length of s1 non-zero 
sl=s2 true if strings identical 

$1.l='s2 true if strings not identical 


textedit [options] [xview options] 
OpenWindows Simple Text Editor (OWV3) 


-Ea onloff whether adjustment makes pending-delete 
-Ei onloff auto-indent, default off 

-Eo onloff can Store as New File overwrite 

-Er onloff read-only 

-EcN checkpoint after c editing operations 

-Eln n lines between caret and bottom (2) 
-Emn n pixels scrollbar margin width (4) 

-Enn number of lines of text, (45) 

-Etn n lines between caret and top (2) 


xview options see xview 
tftp [host] 

trivial file transfer protocol program 

2 print command help information 
tic [options] file 
terminfo compiler 
-v[n] verbose n is 1-10 default 1 
c check file for errors 


time command 
time a command 


timmanp[see mailp] 

timesysp [see mailp] 
frontend to PostScript printer for Time Manager files 
frontend for Time/System International files (OWV3) 


tip [options] host|number 
connect to a remote system 


-entry use entry as speed entry 
“Vv display commands as executed 
commands ~? gives help 


touch [options] files 


update access and modification times of a 
file 

f force touch 

se) do not create file if it did not exist 


tput [options] 
initialize a terminal or query terminfo database (SYSV) 
init initialize according to TERM\ 
reset 
longname 


reset terminal 
print terminal long name 


tr [options] stringl string2 
translate characters 


-c complement string1 

-d delete all input characters in string1 

“s squeeze all repeated output chars in string 2 to 
single chars 


trace [options] command|pid 
trace system calls and signals 


-c print summary of system call and signal counts 
+t prefix each line with time of day 

-0 file output file 

-p pid attach to process pid 


true, false 
produce true or false values 


tset, reset [options] 
establish or restore terminal characteristics 
- print name of terminal (tset) 


“eC set erase to c, default “H or backspace 

-ic set interupt to c, default is “C 

-ke set line kill to c, default is “U 

-S output commands to set and export TERM 


tsort [file] 
topological sort 


ttcp [options] files dest 
copy files in a ToolTalk safe way (OWV3) 
remote copy files in a ToolTalk safe way (OWV3) 


-p preserve time (root only) and mode 
-r recursive, dest must be a directory 
-L copy LM/TT objects only 

-v/-h print version/usage 


ttmv [options] files dest 
move files in a ToolTalk safe way (OWV3) 
remove files/directories in a ToolTalk safe way (OWV3) 
treat following args as filenames 


-f force 
-L move TT objects only 
-v/-h print version/usage 


tttar [options] 

archive files and ToolTalk objects (OWV3) 

c create a new Istarfile 

t list the tabel of contents 
extract 
do not archive other TT links 
use next arg as Istarfile name 
follow symbolic links 
preserve modes 


ryVs > Mm 


do not invoke tar (must use -f) 
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R do not recurse (with -L only) 
Ss only archive TT specs 
Vv verbose 


tty [options] 
get the name of the terminal 
-S do not print name, just give exit code 


ttysoftcar 
enable/disable carrier detect 


tunefs [options] 
tune an unmounted file system 


-amax max is max no of contiguous blocks before rotational 
delay (default 1) 
-d delay time in mS to initiate a 2nd transfer 
-e num max no of blocks from a cylinder group 
-m minfree % of space held back for normal users 
tztool 


set the current timezone for the machine. 


ul [options] 
do underlining 
-t terminal override TERM setting 
-i use a separate line with ‘-’s 


uname [options] 
print name of current system 


-a print all information 

-m print machine hardware name 

-n print nodename 

+r print operating system release 

-S print name of operating system (default) 
Vv print operating system version 


unifdef [options] [files] 


resolve and remove ifdefs from cpp input 


-C complement normal operation 

-| replaced lines removed with blank lines 
+t plain text options 

-iDname ignore but print lines with name 
-iUname ignore but print lines with name 


uniq [options] [input [output] ] 
report repeated lines in a file 


-u output only lines not repeated in input file 
-d write one copy of just the repeated lines 
-c precede with count 

-n skip n fields 

+n skip n characters 


units 
conversion program 


unix2dos [options] from to 


-ascii add carriage returns to conform to DOS 
-iso convert ISO to DOS (default) 
7 convert 8 bit chars to 7 bit DOS chars 


unwhiteout file 
remove a TFS whiteout entry 


uptime 
show how long a system has been up 


users 
display a list of users logged in 


ustar [options] 
process tape archives (SYSV) 


-c create archive 

+r write names to end of archive 

+t list names in archive 

-u add files if do not exist or are modified 
-x extract files 

-b blocking factor default 1, max 20 

-f file file to use 

-| report if cannot resolve all links 

-m do not restore modification times 

-0 give user/group ownership to extractor 
~V verbose 

-W interactive mode 


uucheck [options] 
check uucp directories and permissions file 
-V verbose 
-xdebug debug is 0-9(max) 


uucp [options] source dest 
uux [options] command 
UNIX to UNIX system copy 
UNIX to UNIX system command execution 
make stdin go to command (uux) 


-C force copy of local file to spool directory 

-f do not make intermediate directories 

-ggrade specify service grade 

-j show uucp job ID 

-m send mail on completion 

-nuser notify user on remote system that file was sent 
+r queue job but do not start transfer 

-xN N is debug level (0-9 max) 
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uuencode [file] label 


uudecode [file] 
encode a binary file or decode its ASCII representation 


uulog [options] system 


query uucp log file 
-ssyS print transfer work involving system sys 
-fsystem tail -f of log for system 


uuname [options] 
list UUCP names of systems that can be accessed 
-c display names known to cu 
-| display local system name 


uupick [-s system] 
accept or reject files sent 
. print command summary 


uusend [options] file system 
send a file to a remote host 


-f do not make intermediate directories 
+r queue job but do not start uucico 
-m mode specify mode (octal) 


uustat [options] 
uucp status inquiry and job control 


-a list all jobs in queue 

-p execute a ps for all PIDs in lock files 
-kid kill uucp request with job id of id 

-m report accessibility of all machines 
-q list jobs queued for each machine 
-rid rejuvenate job id 

-ssystem report status for remote system 
-uuser report status for all user requests 


uuto [options] files dest 
public UNIX to UNIX system file copy 
-p copy source file to spool directory 
-m send mail when complete 
vacation [options] 
automatically respond to incoming mail messages 
-| initialize files and start vacation 
-a alias alias is a valid alias 
-j do not check To: or Cc; line for recipient 


-t[N] interval between repeat replies [default 1 week] 


N is integer and s|m|h|d|w seconds-weeks 


vgrind [options] 
grind nice program listings 


2 two column output 

-f filter mode 

-n do not make keywords boldface 
-W TAB in 4 postitions not 8 

-x output index file in pretty format 
-d file alternative language definition file 
-h header header for every page 

-llanguage language to use 

-sn point size to output 


vi [options] file 
screen oriented editor based on ex 


-t tag edit file containing tag 

+t file recover file after crash 

-| set up for editing LISP programs 

-L list files saved as a result of a crash 

-wn set default window size to n 

-R read-only mode 

-X encryption mode 

-c command begin by executing command 
vipw 


edit the password file 


vmstat [options] 
report virtual memory statistics 


-C report cache flushing statistics 
-f report fork info 

-i report interrupts info 

-S report paging info 


report swapping info 


w [options] 
who is logged in and what are they doing 


-h suppress the heading 
-S short form output 
wait 


await completion of a process 


wall 
write to all users 


we [options] files 


word count 

-| count lines 

-w count words 

-c counr characters 


what [-s] file 
extract SCCS version from a file 
-s stop after first occurence of pattern 


whatis command 
display a one line summary about a command 


whereis command 
locate binary, source and manual pages for a command 


which [filename] 
locate a command; display pathname or alias 


who [options] 
who is on the system 
file use file instead of /etc/utmp 
ami prints who you are 
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whoami 
display effective current username 


whois [-h host] identifier 
Internet user name directory service 


winsysck [options] 
check which window system protocols available (OWV3) 


-a continue after first protocol found 
-v print names on stdout 
-display string use display string 


write floppies [ -v ] [ device ] 
write data to a set of floppy disks 


-V verify each diskette after it has been written. 
device specify device to be used forrenice priority pid 


write user [line] 
write to another user 


xargs 
construct argument list(s) and execute command 


xauth [options] 
X authority file utility (OWV3) 


-f authfile authority file to use 

-V verbose 

-i ignore authority file locks 

-b break locks 
xdpyinfo 


display information utility for X (OWV3) 


xfontsel [options][xview options] 
X font selection utility (OWV3) 
-pattern name use name as pattern to match against 
-print write specifier to stdout on close 

use text in place of default 

see xview 


-sample text 
xview options 


xhost [options] 
server access control program for X (OWV3) 
- turn access control on (default) 
+ turn access control off 
+hostname allow hostname access 


-hostname remove hostname from access list 
xinit 
X Window System inilializer (OWV3) 


xlock [options] 
lock an X display until password is entered (OWV3) 
-display dsp display to lock 
-mode x hop|life|qix|image|swarm|rotor|blank 


-delay usecs delay between batches 
-batchcount n n is number of things to do 
-nice level level is nicelevel 


-timeout secs 
-saturation v 


number of seconds till password times out 
v is sturation of color ramp (0-1) 


-font name font for prompt screen 


-fg color text on password screen to color 

-bg color background on password screen to color 
-/+mono display in monochrome 

+/-nolock draw patterns but do not lock display 


-/+allowroor allow root password to unlock 


-/+enablesaver will disable normal screen saver 


xlogo 
display X Window System logo (OWV3) 


xlsatoms 
list interned atoms on a server (OWV3) 


xlsclients [options] 
list client applications running on a display (OWV3) 


-display dpy display to use 

-a all 

-| long listing 

-m max no of chars per command 


xlsfonts [options] 
server font list displayer for X (OWV3) 


-display dpy display to use 

-[,-Il,-lll medium, long, very long listings 

-m long listing also prints min and max 
-C use multiple columns 

-1 use a single column 

-w width width to print, default 79 


xlswins [options] 
server window list displayer for X (OQWV3) 


-display dpy display to use 
-l long listing 
-indent no indent spaces per level 


xmodmap [options] [filename] 
utility to modify keymaps in X (OWV3) 


-display dpy display to use 

-help help 

-grammar help on grammar 

-verbose print logging info 

-n display what xmodmap would do 
-e expression execute expression 

-pm print current map 

-pk print current keytable 

-pp print current pointer map 


use stdin as input file 


xnews [options] 
window system server (OWV3) 


‘display listen for X11 and NeWS on display 
-auth file authorization file 

-defeatsecurity disable security 

-fp path set a default font path 

-nobanner do not display OWV3 banner 
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xpr [options] 


-bg color 


background color 


print an X window dump (OWV3) “IV exchange backgound and foreground 
-device dev dev is la100||jet|pjet|ps -display dpy display to use 
-scale scale scale bit to grid 
-height inches —_ max height of page xstr [options] files 
-width inches max width of page extract strings from C programs for shared strings 
-left inches left margin -c file take C source text from file 
-top inches top margin -V verbose 
-header string string to be printed above window -| array specify array [xstr] 
-trailer string string to be printed below window | 
-landscape landscape mode xv_get_s el [options] 
-portrait portrait mode copy contents of a selection to standard output (OWV3) | 
“Vv reverse video -rank 1 is primary, 2 is secondary, 3 is clipboard 
-compact use run-length encoding -t secs waits secs for response 
-psfig do not put postcript picture into center 
xview 
xprop toolkit information for X (OWV3) 
property displayer for X (OWV3) -Wx small|medium|large|extra_large 
-help print command line options -Wt fontname 
“grammar help on grammar -Ws x y width and height in pixels 
-Wp xy initial position in pixels 
xrdb -Wg g geometry format [WxH][+|-X+|-Y] pixels 
X resource database utility (OWV3) -WP xy icon position in pixels 
-WI window title if not overwritten by app 
xrefresh +Wil-Wi come up open or iconized | 
refresh all or part of an X screen (OWV3) -Wfrgb foreground color 
-white use a white background -Wbrgb background color 
-black use a black background -fg string foreground color 
-solid color use a background of color color -bg string background color 
-root use the root window background -WI string icon image if not overwritten by app 
-geometry g area to refresh WxH+X+Y -WL string icon label if not overwritten by app 
-display dpy display to refresh -WT string icon font 
-Wd string string set resource with no command line equivalent 
xsend username -WH print help 
xget -Wr display set display 
enroll 


send, receive and set up secret mail 


xset [options] 
user preference utility for X (OWV3) 


-display dpy display to use 

b on/off bell on or off 

c on/off keyclick 

fp=path,... set font path 

fp default reset font path to default 
[+/-]fp[+/-] prepend or append font paths 

m acc thr mouse acceleration and threshold 
p entry col pixel color map entry and color 

t on/off autorepeat 

s on/off screen saver 


xsetroot [options] 
set root window parameters for X (OWV3) 
-def set defaults 
-cursor cfile mfile set cursor to cursorfile and maskfile 
-cursor_name Cc set cursor to name c 


-bitmap file use file for background tiles 
-mod x y x/y 1-16 to set plaid 

-gray background gray 

-fg color foreground color 


xwd [options] 
dump an image of an X window (OWV3) 


-display dpy 
-nobdrs 
-out file 

“xy 

-add value 
-frame 


display to use 

no border 

output file 

use xy format, default is z 

add value to every pixel 
include window manager frame 


xwininfo [options] 
window information utility for X (OWV3) 


-rootroot window 


-int 
-tree 
-stats 
-bits 
-events 
-size 
-wm 
-frame 
-metric 
-english 
-all 


display window IDs as integers 
display root,parent and children 
display info 

display info on raw bits 

display event masks 

display sizing hints 

display window manager hints 
do not ignore frames 

display mm and pixels 

display in and pixels 

display everything 
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xwud [options] 
image displayer for X (OWV3) 


-bg color if bitmap color for 0 bits 

-display dpy display to use 

-fewcolors use for small no of colors 

-fg color for mono bitmap color for 1 bits 
-geometry g geometry to use 

-help help 

-in file input file, default stdin 

-new create a new colormap 

-noclick do not terminate on window click 
-plane no display single bit plane 

-raw use current colors 

-1V reverse colors 

-std map map is RGB_X_MAP, X is BEST, DEFAULT or 


GRAY 
yacc [options] grammar 


yet another compiler-compiler 

generate y.tab.h with define statements 
generate y.output 

-| generate y.tab.c with no numbered line directives 
set yydebug 


yes [string] 
repeatedly output y or string 


ypcat [options] mname 
ypmatch [options] key mname 
print values in an NIS database 
print value of one or more keys from an NIS database 
-d domain 
-k 
-X 


specify a domain other than the default 
display keys for maps with null values 
display map nickname table 


ypinit [options] 
build and install an NIS database 


-m local host is to be master 
-s host set up a NIS slave server database from host 
ypmake 


rebuild NIS database 
cd /var/yp; make 


yppasswd [username] 
change your network password in the NIS database 


ypwhich [options] 

return name of NIS server or map master 

-d domain specify a domain other than the default 

-m mname find NIS server for map mname 

-X display map nickname table 
zdump [options] 

time zone dumper 

-V verbose 
-c year cut off at year 


zonenames zones to print time out 
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INTERNATIONAL 
KEYBOARD SUPPORT 


The SPARCbook 2 notebook workstation is available with a variety of keyboard layouts which can 
be specified at the time of ordering. Commands and key-press examples in this guide assume that 


the SPARCbook 2 is fitted with a standard U.S. ASCH keyboard layout. 


Keys that are associated with the mouse and display, and the Save and Reset functions are mapped 


to the same physical location all on the currently available keyboard layouts. 


The various international keyboards are illustrated on the following pages for reference. 
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GERMAN 
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Symbols 

thosts 196 
/etc/defaultrouter 195 
/etc/hosts 193 
/etc/printeap 147 
/etc/ttytab 163 
/var/spool/lpd 148 


A 
a2ps 173 
Accounts 44, 47 
Adjustkey 31, 58 
Appointments 97 
ASCII Terminal 163 
Audio 246 
Mail attachments 87 
Playback 123 
record 124 
Audio Interface 250 
Audio mail attachments 125 
Audio Tool 122 
Display Canvas 123 
Audio Tool Summary 126 
Automatic Low Battery Save 34 
Automatic mail response 87 
Automatic system shutdown 143 


B 


Back (move window to) 62 
Backup and restore 215 
Battery charging 139 
Battery LED 33 

Battery Low Warning 139 
Battery Monitor 38 
Battery replacement 140 
Bottom Anchor 64 


Brightness control 28 


INDEX 


Browsing remote calendars 99 


Cc 

Calculator 115 
Calendar Manager 96 
Case and Emissions 247 
Clipboard 80 


Clock 115 
Close 62 
Color 


Windows 130 
Workspace 130 
Command Tool 114 
Configuring fora network 42 
Connecting 
akeyboard 158 
amicrophone 122 
aprinter 146 
aSCSI Device 166 
an ASCII terminal 163 
anexternal display 151 
an X terminal 165 
headphones 122 
Connecting to aremote system 118 
Connector reference 248 
Console 136 
Control Areas 65 
Controlling the User LED 264 
Copying files 78 
Customizing Calendar Manager 101 
Customizing OpenWindows menus 132 


D 

DC Power connector 248 
DC Power Supply 248 
Deleting afile 69 
Deleting mail 85 


Demo account 52 
Demonstration account 47 
DeskSet Startup 130 
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